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Preface 


Unreal Engine 4 (UEA) is a complete suite of game development tools made by game 
developers far game developers. With mare than 80 practical recipes, this book is a guide 
that showcases techniques to use the power of Ces scripting hile developing games with 
UL We wl start by adding and editing C++ classes from within the Unreal Editor. Then 

we wil delve into one of Unreal primary strengths--the abilty for designers to customize 
rogamrer developed actors and component. Tris wil heip you understand the benepts of 
‘then and how to use C++ as a scing tool. With a blend of task-oriented recipes, this book 
will provide actionable information about scripting games with UES and manipulating the 
game and the development environment using C+ Toward the end of this book, you willbe 
Empowered to become a top-notch developer with UES using C++ as the scripting language. 





r 
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Chapter, UEA Development Toots, outlines basi recipes to get you started with UES game 
development and the Basie tools used to create the code that makes your ame 





his book 
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Chapter 2, Creating Classes, focuses on how to create C+ casses and structs that integrate 
wel withthe UES Blueprints Editor. These classes wil be graduated versions of regular C++ 
lasses called UCLASSES, 


Chapter, Memory Management and Smart Pointers, takes the reader through using all three 
"pes of pointer and mentions some common pitfalis regarding automatic garbage collection. 
‘This chapter also shows readers howto use Visual Studio or XCode to interpret crashes or 
contrmthat the functionalityis implemented corey 


Chapter, Actors and Components, deals with creating custom actors and components, what 
purpose each serves, and hon they work together 


Chapter 5, Handing Events and Delegates, describes delegates, events, and event handlers, 
and guides you through creating their omn implementations 
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Chapter, Input and Colision, shows how to connect user input to C++ functions and how to 
handle collisions in C++ rom UEA. t wl also proie default handing of game events such as 
user input and collision, allowing designers to override when necessary, using Blueprint. 


Chapter, Communication between Classes and Interfaces, shows you how to write your own 
Uinterfaces, and demonstrates how to take advantage of them within C++ to minimize class 
coupling and hel keep your code clean. 


Chapter, Integrating C++ and the Unreal Editor, shows you how to customize the editor by 
‘creating custom Blueprint and animation nodes from scratch. We wil also mplemen custom 
editor windows and custam detail panels to inspect types created by users. 


‘Chapter 9, User interfaces - UI and UMG, demonstrates that displaying feedback to the player 
is one of the most important elements within game design, and this wil usual involve some 
sort of HUD, or at least menus, within your game. 


‘Chapter 10, A for Conroling NPCs, covers recipes to conto your NPC characters with a bit of 
Artipcial irteligerce (A) 


Chapter, Custom Materials and Shaders, talks about creating custom materials and audio 
graph nodes used in the UEA editor. 


“Chapter 12, Working with UEG APIs, explains thatthe application programming interface (API) 
iS the wayin which you, as the programmer, can instruct he engine (and so the PCJ on what to 
do, Each module has an API for t. To use an API, there is a very important Inkage step where. 
ou must ist all APs that you wil usein your buld in proj ect Name. Suid 


What you need for this book 


‘Creating a game is an elaborate task that wil require a combination of assets and code. To 
‘create assets and code, we'l eed some pretty advanced tools, including art tools, sound 
aats, level-editing nos, and codeediting tools. Assets include any visual artwork (2D sprites, 
30 models), audio (music and sound effects], and game levels, To perform that, we'l setup 
a C++ coding environment to build our UES applications. Well download Visual Studio 2015, 
install it, and set it up for UE C++ coding. (Visual Studi is an essental package for code 
ding when edting the C++ code for your UEA game. 


Who this book is for 


‘This book is intended for game developers who understand the fundamentals of game design 
and Ce ond would ike to incorporate native code into the games they make with Unreal. 
‘They wil be programmers who want to extend the engine or implement systems and actors 
that alow designers control and joxiity when building leeis 
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Preface 


In this book, you vil rd several heacings that appear frequertiy (Getting ready, Howto dit, 
How it works, There's more, and See also). 





To give clear instructions on how to complete a recipe, we use these sections as follows: 


Getting ready 


This section tells you what to expectin the recipe, and describes how to setup any software or 
any preliminary settings required for the recipe. 


How to do it.. 


‘This section contains the steps required to follow the recipe. 


This section usually consists of a detailed explanation of what happened in the previous 
seton. 


There's more. 





‘This section consists of addtional information about the recipe in order to make the reader 
more knowledgeable about the recipe. 


See also 


‘his section provides helpful inks to other useful information forth recipe. 


Conventions 


In this book you wäl rd a number of test styles that distinguish between ferent kinds of 
information Here are some examples of these styles and an explanation of their meaning 


Code voris inte, database table names, folder rames, enormes He eensions, 
pathnames, dummy URLs, user input, and Twitter handles are shown as follows: The 
parameters passed to the UPROPERTYT) macro specify a couple of important pieces of 
information regarding the variable.” 
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A block a code is set as fallons: 


puta( Welcome to Visual Studio 2018 Community Editi ont*| 


When we wish to draw your attention to a particular part ofa code black, the relevant lines or 
tems are set in bold: 
float HoatYar = 3.71 
string fstringYar = "an fstring vari abl 
it Loc(LesTems, Waralng, TEXTO Tent, Sd M en), Jeter 
Haatiar, stringa 15 








New terms and important words are shown in old Words that you see on the sereen, for 
example, in menus or dialog bowes, appear in the test ike this: "After you select the tol you'd 
ike to add on to Visual Studio, cick the Next button, 


[sé Waring or important notes appear in a bocice tis ] 
[8 ee ] 
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back 


Feedback fom our readers is always welcome. Let us know what you think about this book— 
what you liked or disliked. Reader feedback s important for us as It helps us develo tiles 
"Bat you wil really get the most out of. 


To send us general feedback, simply emailt eedbackgpactt pub. cem, and mention the 
book ttle in the subject af your message. 


1 there is a tople that you have expertise in and you are interested in either writing or 
contributing toa book, see our author uide atm. packt pub. com aut ha 
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Now that you are the proud omer of a Packt book, we have number f things to help you to 
get the most from your purchase, 


Downloading the example code 


You can dounload the example code ples for this book from your account ath to: 
wmn. packt put. con. you purchased this book elsewhere, you can veit htt p: I). 
packt put. com support and regsterto have the Bes erailed drectiyto you. 


‘You can donload the code es by folowing these steps: 

Log in or register to our website using your email address and password 
Hover the mouse pointer on the SUPPORT tab at the top. 

(Click on Code Downloads & Errata. 

Enter the name of the book in the Search box. 

“Select the boak for hich youre locóng to download the code Hes. 
‘Choose from the drop-down menu where you purchased this book from 
Click on Code Download. 


‘Yu can also download the code Hes by clicking on the Code Files button on the book's 
webpage at the Packt Publishing website. This page can be accessed by entering the books 
name in the Search box Please note that you need to be logged in to your Packt account 


Once the He i dowrlcaded, please make sure that you unzip or etractthe folder using the 
latest version of 
^o MIRARI Zip for Windows 
* peg] iZip/ Unharktfor Mac 
* pi PeaZip for Linux 
The code bunde for the book is also hosted on GitHub atit tps: (github. caet 
Packt Publishing Unreal -Engi ne-4- Scri pting-with-CPlusPlus- Cookbook. 


We also have other cade bundles from our rich catalog o books and videos available at 
https: ligi thub. com Packs Publi shi eg] Check them out! 
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Downloading t 


‘Wi also provide you with a PDF He that has color images of the screenshot agra used 
inthis book. The color images wil help you better understand the changes in the output. You 
‘can donniood ths He fmt tps: /} waw. packt pub. com sites/ def aul t/ Tiles! 
domni oads/ Unreal Eng) nedScri pti ngwi t AC, Cookbook Colori mages. pdf 


[though we have taken every care to ensure the accuracy of our content, mistakes do 
Tappen: Ifyou [rd a mistake în one of cur bocks\maybe a mistake in the est or the 
ode—we wouid be grateful if you could report this to us. By doing so, you can save other 
racers from frustration and heip us improve subsequent versions of ths book. Ifyou pnd 
any erat, please report them by visiting tp: { wun. packt pub. com submi t-errata, 
Selecting your book, clicking on the Errata Submission Form Iink, and entering the details of 
Your errata. Once your errata are veriped, your submission váll be accepted and the errata will 
De uploaded to our website or added to any list of existing errata under the Errata section of 
that te, 


To vien the previously submitted errata, goto htt ps: | wu. packt pub. cos books 
cantent [support ardenter the name of the book in the search peld. The required 
information wil appear under the Errata section. 


Pracy of copyrighted material on the intemet is an ongoing problem across all media. 
At Packt, we take the protection of our copyright and licenses very seriously. If you come 
across any ilegal copies of our works in any orm on the Internet, please provide us with 
the location address or website name immediately so that we can pursue a remedy. 


Please contactus atcopyr ght gpactt pub. com with a link to the suspected pirated 
material. 


We appreciate your help in protecting our authors and our abiltyto bring you valuable 
content 


ifyou have a problem with any aspect of this book, you can contactus at quest ans 
packt put. com, and we wil do our best to address the problem. 
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UE4 Development Tools 


IN this chapter, we will outine bas recipes for getting started in UEA game development, and 
the basie tools that we use for creating the code that makes your game. This will include the 
folowing recipes: 


Installing Visual Studio 
Creating and building your rst C+ project in Visual Studio 

Changing the code font and color in Visual Studio 

Extension - changing the color theme in Visual Studio 

Formatting your code (Autocomplete settings) in Visual Studio 

Shortcut keys in Visual Studio 

Extended mouse usage in Visual Studio 

UEA - installation 

UEA b prst project 

Us 6 creating your steve 

VEA - logging with ue L0G 

UA - makingan Fst ri ng fom Fst ri ngs and other variables 

Project management on GitHub - getting your Source Control 

Project management on GitHub - using the Issue Tracker 

Project management on VisualStudio.com - managing the tasks in your project 
Project management on VisualStudio com - constructing user stories and tasks 





VEA Development Tools —— 


Introduction 


‘Creating a game san elaborate task that wil require a combination of assets and code. To 
Great assets and code, we'l need some pretty advanced tools including art tools, sound 
"ool, evel editing tools, and code editing tol. In this chapter, wet discuss Ending suitable 
taal far asset creaton and coding. Assets include any visual artwork (2D sprtes, 3D models], 
audio (music and sound effects], and game levels. Coe i the tx (usually C+) hat instructs 
the computer on how to tie these assets together to make a game word and level, and how 
to make that game world play" There are dozens of very good tool for each task; we wil 
explore a couple of each, and make some recommendations. Game edting tools, especialy, 
are hefty programs that require a pomerful CPU and ots of memory, and very good, ideal 
GPUs for goad performance. 


Protecting your assets and wark is also a necessary practice. Vell explore and describe 
source control, which is how you bacik up your werk on a remote server, An Introduction to 
Unreal Engine 4 Programming is also included, along with exploring basic lagging functions 
and ibraryuse. Sigsicant planning is also required to get the tasks done, so we'll use a task- 
Banner sftware package to do so. 





Visual Studio is an essential package for code editing when editing the C++ code for your 
Ue game, 


Getting ready 


Were going to set up a C++ coding environment to build our UES applications. Well download 
Visual Studi 2015, stali lt, and setup for UEA C++ coding. 


How to do it... 


1. Begin by visting: ps: / | wam. vi saal studi a. com en-usj products) 
visual -stugio-comuai ty- vs. ss pr. Cick on Download Community 2015 
Tris downloads the -200 KB loader installer 


sual Stu 
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‘You can compare edtions of Visual Studio attt s [] www; 

Po) visuatstudta,con/en-us/products/ compare- visual -studi 

Ay 2015: product vs, area. The Community Edison of Visual Studia s 
Suly adequate for UEA development purposes în this Book 





2. Launch the installer, and select the components of Visual Studio 2015 that you want 
"o add to your PC. Keep in mind that the mare features you select, the larger your 
installation wil be. 


0 Visual Studio 





The preceding screenshot shows a recommended minimum installation, wth 
Corre Tool for Visual C 2015, Gt for Windows, and GitHub Extension for 
Visual Studio al checked, We wil use the Git for Windows features in a later section 
in this chapter, 





UES Development Tools 


3. Mieryou have selected the tools youl like to add onto Visual Studio, click the Next 
Button. The installer tool wil download the required components, and continue setup. 
instalation should take 20-40 minutes, depending on your option selections and 
connection speed. 

4. Atter you download and install Visual Studio 2025, launch t You wil be presented 
wth a Sign in dialog ox. 





0@ Visual Studio 


Welcome! 
Connect to all your developer services. 














You can Sign in with your Microsoft account (he one you use ta sign into Windows 10), or 
Sign up fora new account. After uve signed in or signed up, you will be able to sign into 
Visual Studio tel. t may seem odd to sign into a desktop code editing program, but your 
Sigin vill be used for source control commits to your repositories. On st sigringin to sual 
‘Studio, you can select one time oniy) a unique URL for your source code repositories as 
Posted on Visualstudiocom. 


Visual Studio is an excelent editor, and you wil have a fantastic time coding within it In the 
nent recipe, weti discuss how to create and compl your oun code. 





ng and building your prst C++ project 





In order to compile and run code from Visual Studio, it must be done from within a project. 


e 








Getting ready 


in this recipe, we wil identity how to create an actual executable running program from Visual 
‘Studi, We wil do so by creating a project in Visual Studio to host, organize, and compie the 
code. 


How to do it... 


In Visual Studio, each group of code is contained within something called a Project. A Project 
isa buildable conglomerate of code and assets that produce either an ecutabe exe 
runnable ora library £ 1 b, ar. á| 1 ).A group f Projects can be collected together into 
Something called a Solution. Les start by constructing a Visual Studio Solution and Project 
for a console application, followed by constructing a LES sample Project and Solution, 


1 Open Visual Studio, and g to File | New | Project. 
2. You wili see a dialog as flows 
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Select Win32 in the pane on the lfthand side. In the righthand pane, hie Win32 
Console Application. Name your project in the lower box, hen hi OK. 
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3. Inthe next dialog box we speci the properties of our console application. Read the 
Inst dialog boxand simply cick Next. Then inthe Application Settings dialog, 
choose the Console Application bullet, then under additional options, choose 
Empty project. You can leave Security Development Lifecycle (SDL) 
checks unchecked. 





oo |m 
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4. Once the application wizard completes, you wil have created your st project. Both 
a Solution and a Project are created. To see these, you need Solution Explorer. To 
ensure that Solution Explorer is showing go to View | Solution Explorer (or press 
Cri «At + LI. Solution Explorer is a window that usually appears docked onthe 
lefthand side or right-hand side of the main editor window as shown in the folowing 
screenshot 








"WI rere Micrveh Vin 
Ble Eat View Project Bold Debug 
DEM Debus 
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Qptart 
Solution Explorer also displays all the Hes that are part of the project. Using Solution 
Explorer, we wil also add a code He irto the editor: Right dick on your Project 
First Pr aj ect, and select Add | New item. 












5. in the next dialog, simply select C+ File (cpp), and dve the He any name you'd liee. 


Tcaled mine ai». cis 


M meme 





6, Once you have adde thee it wil appear in Solution Explorer under your 
First Pr a1 ect's source He ter As our Project grove, more and more Hes are 
ong to be added to your project You can comple and run your þrst CH program 
Using the flowing teat: 


t 


puts] Wel come ta Visual Studio 2813 Cemmerity Editi aet) 
i 
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7. Press C+ Shift +B to bull the project, then Cil + F5 to run the project 


8. Your executable wil be created, and you wll see a small lack window with the 
results of your programs run: 


Building an executable moves translating your C+ code from tet language to a binary 
Be. Running the He uns your garne program which is just the code tes that occurs in the 
mai ri] function between ( and) 


There's more. 


Buld conpguraiors are styles of buld that we should discuss them here. There are at least 
Pro important bul corpaurations you should know about Debug and Release. The Bul 
corbrasation selected is at the top af the editor, just below the toolbar in the dtu pasion 








M vet Gulla, Uriaren 
Te RA Ww Ped Pel peig AAR “Tes Tor Mae Wer Hee 
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Depending on ubich corbation you select, different: compiler options are used. ADebug 
rbauraion bpicallyindudes etensivedebuginfometion nthe buld as wel as tuming olf 
‘oplimzabors to speed up camplaton. Release buide are often optimized ether for size or for 
Speed) take a bit longer to build, and resuk in smaller or faster executables, Behavior stepping 
‘ough with the debugger is often better in the Debug made than the Release mode, 





font and color in Visual 





Changing the 
Studio 


‘Customizing the font and color in Visual Studio is not cy etree eile, you váll also bd 
t verynecessaryif jour monitor resolution s quite high or quie low 








Getting ready 


Visual Studio is a highly customizable code editing tool. You right rd the default fants oo 
smal for your sereen, You may want to change your code's font size and color, Or you may 
nt to completely customize te coloration of Keywords and the text background colors: The 
Fonts and Colors dialog box hich metl show you how to use in this section, allows you to 
completely customize every aspect of the code editors font and color. 





imt maint) 
t 
ps Welcne to Visual Studio 2015 Comunity Edition!” 


1 


How to do it. 


1. From within Visual Studio, go to Tools | Options. 
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2, Select Envranment | Fonts and Colars from the dialog that appears. It wil ao Ike 
the folowing screenshot 
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3. Play around with the font and font size of Text Editor Plain Text. Click OK on the 
alo, and se the results in the codeto editor. 








Ane meg) 
t 
past 
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D: 











Text Editor Plain est describes the font and size used for all code ax within the regular 
code editor, I you change the size of the ont, the size changes Tor any ta entered into the 
‘coding window (for ali languages including C. CH, C, and others 









Clean 








The color foreground and background) is completely customizable for each tem. Ty this for 
the Text Editor Keyword setting (affects all languages), or for Cekspecpr tas, such as 


Te Editer C4 Functions. Cck OK, and you wil see the changed ero of the om rejected 
inthe code editor. 


‘ou ray also want to canbe the font size af the Output Window choose Show settings for 
=> Output Window as seen in the olloning screenshot 




















The Output Window i the litle window at the bottom af he editor that displaye bul resulte 
and compiler errors. 


= 





Chapter 





‘You cant save-out (export) ar bring in [mpor) your changes to the Forts 
and Colars dialog. But oa can use something called the Visual Studio 
"Theme Estar enin, leam more refer t Extension - changing the color 
‘theme in Visual Studio to export and import custorsized color temes 
Forthis reason, you may want to avoid changing fant colors from this dialog- 


You must use this dialog i change the font and fontsize, however, foray 
seting (at the time af ting 


The Fonts and Colors dialog simply changes the appearance of code in the test editor as 
well as Tor ather windows such asthe output window. Iis very useful far making your coding 
‘envenment more comfortable 


Orce you have customized your setings, youl nd that you may vant to save your customized 
Fonts and Colors settings for others to use, or to put into anther Installation of Visual Studio, 
"which you have on another machine. Unfortunatly by default you wont be abl to save-cut 
our customized Fonts and Colors settings, You wil need something called the Visual Studio 
‘Thame Editor extension to do so. We wil enplore this in e net recipe 


See also 


‘+The Extension changing the colar theme in Visual Studio section describes how to 
import and esport color themes 


Extension - changing the color theme in 


Visual Studio 





By default, you cannot save the changes you make to the font colors and background settings 
at you make in the Fonts and Colors dalog: To xt issue, Visual Sudo 2015 has a 
feature caled Themes. If you go to Tools | Options | Environment | General, you can change 
the theme to one of te three preinstated stock temes (Light, Blue, and Dark) 











mr 
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‘Afferent theme completly changes the loo of ial Studio-irom the colors of the ie. 
bars to the background color of the tet editor window. 


‘You can also customize the theme of Visual Studio completely, but yout need an extension 
ta do so. Extensions are litle programs that can be installed into Visual Studio to madify le 
behavior 


By default, your customized colar settings cannot be saved ar reloaded Into another Visual 
Studio installation without the extension. With the entension, you il also be able to save your 
oum colar theme to share with others. You can also load the colar settings made by another 
persan ar by yourself into a resh capy of Visual Studia, 


1. Goto Tools | Extensions and Updates. 

2, From the dialog that appears, choose Online in the panel on the lefthand side, Start 
typing Theme Edi ter into the search boxat the ight The Visual Studio 2015 Colar 
Theme Editar dialog wil pop up in our search results. 








3. Gickthe small Download button in the top right hand comer af the entry Click 
‘through the installation dialog prompts, allowing the plugin to install. After 
installation, Visual Studio wil prompt you to restart. 


Morro vist ht tps: visual studi ogal lary. medn, 
mierosatt cam Bt t9Sibe-Scbe-4a81-e05-1igsa860420b 
and downisad/instali the extension by doublecicking the. v51 x that 
comes irom your brouser 


4. Click Restart Now to ensure the plugin is loaded, 














Chapter 2 
S. After restarting, goto Tools| Customize Colors to open the Color Themes editor page. 
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5. om the olor Themes dlalog that appears, cick on the Ite palette shaped icon 
n the upper ht comer f the theme that you want to use as your base or starting 
"heme (Iv cicked on the palette for the Light theme here, as you Can see in the 
folowing screenshot. 










Installed Themes 
1. Click to duplicate theme 





Pis eleme 
emer 
E - 








X Acopyof the theme wl appear i the Custom Themes section in the ower part ot 
‘the Color Themes window, Ciek on Edit Theme ta modify the theme. When you are 
ling the theme, you can change everything from the font tet color to the C++ 
Keyword colar 





mL 
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3. The main area you are interested in isthe C+ Text Editor section. To gain access to 
alle C+ Test Editor options, be sure to select the Show All Elements option at the 
top of the Theme Editor window, as shown in the folloning screenshot: 

















Saga O CENTS 





Be sure to ee te Show AI Elements opten in the Teme Er 
NR recon ta stow Ca specife tor estor stings Ober, ule 
Tete Core GU pe modeste eng portion 


3. Note that, while most of the settings you are interested in wil be under Text Editor 
| CI Ctt some wil nat have that C+-subheading For example, the seting for the 
‘main/plain text inside the editor window (for al languages} s under Text Editor | 
Plain Text without the C++ subheading). 

10. Select the theme to use fram Toots | Options | Environment | General. Any new 
themes you have created wil appear automaticaly in the drop-down menu. 


Once we lad the plugin, it integrates into Visual Studio quite nicely: Eporting and uploading 
our themes to share wth others ts qut easy too, 


[Adding a theme to your Visual Studio installs itas an extension in Tools | Extensions and 
Updates... Ta remove a theme, simply Uninstall s Extension. 
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‘Autocomplete 





CCode-witng formatting wih Visual Studio is a pleasure. n this recipe, wel discuss how to 
contro the way Visual Studio lays out the tent of your code. 


g 





g ready 


Code has to be formatted correctiy You and your co programmes will be able to better 
understand, grok, and keep your code bugfree ifti constent formatted. This is why 
Visual Studio includes a number of auta formatting ci inside the editor. 


How to do it. 


1. Goto Tools | Options | Text Editor | CY C- This dialog displays a window that 
allons you to toggle Automatic brace completion. 











Automatic brace completion is the feature where, when you type {a corresponding 
1 is automatically typed far you. This feature may tk you H you don ike the text 
editor inserting characters for you unexpectedly. 
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‘You generally want Auto list members on, as that displays a nice dialog with the 
complete names of data members listed for you as soon as you start typing. This 
makes it easy to remember variable names, so you dort have to memorize them: 


[int an 










dmt cartass, carspeed; 





K you press Ct + Spacebar inside the code editor at any 
deme, Dhe aut Ist pops up 


2. Some mare autocomplete behavior options are located under Text Editar | C/ Cet 
Formatting: 





2) | natai narentani peate 








| Gaana 




















Autotormat section: Highlight a section of test and select Edit | Advanced | Format 
Selection (Ctl +K, Cir +F). 





it work: 


The default autocomplete and autoformat behaviors may ik you. You need to converse with 
your team on how you want your code formatted (spaces or tab indents, se of indent, and so 
on), and then cone your sul Studio settings according 
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‘Shortcut keys eally save you time when coding Knowing shortcut keys offhand is always good 


Getting ready 


There are a number of shortcut keys that will make coding and project navigation much. 
faster and rore fient for you: In this recipe, we describe howto se some af the common 
shortcut keys that wil really enhance your coding speed, 


How to do it... 


The folowing are some very useful keyboard shorteuts for you to try: 


1. Click on one page cf the cade, then click somewhere else, at least 10 ines af code 
amay Now press Cri +- [navigate backwards] Navigation trough different pages 
‘of source code (the last place you were at, and the pace you are at now] is done by 
pressing Ciri +- and Cit + Shi + -respectively 


















Warpisgamund i the text ettar using Ct +The cursar wil jump back 

RESI e merean i ipe acode ay, een 

B ine tast cation was in a separate le 

Soy for example, youre erting code in ane place, and you want to go back tothe 
piace youve just been or go back to the section inthe code you came from), Simpy 
Press C+ and hat wil warp you bec to the location in tne code you were at last 
To warp fornard to the caton you were at before you pressed C+ press Ct + 
Sits To warp back, tne prevous locaton shouid be more than 10 ines amay, ar 


ina different He. These correspond to the Forvard and Back menu buttons in the 
toolbar 
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2. Press C+ Wo highlighta single word. 


3. Press and hold Ctl + Shit + right arrow (or left arrow) (not Shit + right arrow) just to 
mave to the right and left of the cursor, selecting entire words. 

4. Press Cre C to copy tent, Cit X to cut text, and Ctrl + Vto paste e. 

5. Clipboard ring: The clipboard ring isa kind of a reference to the fact that Visual 
‘Studio maintains a stack af the last copy operations. By pressing C +C, you push 
the tent that you are copying into an effective stack. Pressing CY! + Ca second 
‘ime on diferent txt pushes that tert into the Clipboard Stack. For example, in the 
olloning diagram, we pressed Ct 4 C on the wor cyclic Is then Cr + C on the 
‘word paste afterwards 





meee ence 


Je you know, pressing Ct + V pastes the top item in the stack. Pressing Cul + Shift 
+V accesses a very long history of all the tems ever copied in that session, nat is, 
ems underneath the top hem m the stack Ater you exhaust the Ist of tems, the 
ist wraps back to the top item in the stack. This i an odd feature, but you may pnd it 
usetul occasionally. 

















5, Chi +M, Ctl M collapses a code section. 




















How it works. 


Keyboard shortcuts allow you to speed up work in the code editar by reducing the number of 
mause reaches that you have to perform in a coding session. 
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E 


The mouse is a pretty handy tool for selecting tex. In this section, wel highlight how to use 
the mouse in an advanced way for quick edits to your code's tet. 


How to do it... 


1, Hold down the Ct key whe clicking to select an entire word, 


2. Hold down the Alt key to select a boxof tox (At + Left Click + Drag), 


nded mouse usage in Visual Studio 








Fstring name = [SIPIREEPrint( 
* clock - Rew EISE rane, 














You can then eter cut, copy, or overwrite the boxshaped tx area. 


Mouse clicking alone can be tedious, but with the help of Cr + AR becomes quite cool. 
Tiy At + Left lek + Drag for selecting a row of tx then typing as well The characters you. 
‘ype wil be repeated in rows. 


There are a nurrber of steps to follow to intall ard canbe LEA properly In this recipe, 
weil walk through the corect installation and setup of the engine. 


Getting ready 


UES takes up quite a few GB of space, so you should have at least 20 GB orso free forthe 
installation on the target drive 
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How to do it. 


1, Visit unreslengine.com and download it Sin up far an account required, 

2. Rune installer for the Epic Games Launcher Program by double-clicking the 
Epi cGamesLauncherl nstal ler- x.x. 1-rnx- msi installer Install tin the 
delautiocation. 

3. Once the Epic Games Launcher program s installed, open it by double-clicking ts 
icon on your desktop or in the Start menu- 

4. Browse the start page and take a look around. Eventually. you wil need to installan 
engine. Clk on the large arange Instal! Engine button on the top leftside from the 
UEA tab as shown in the following image: 


5. Apopup dialog wil show the components that can be installed. Select the 
‘components you'd ike to install The recommendation is 1o begin by installing the rst 
three components (Core Components, Starter Content, and Templates and Feature 
Packs). You can leave out the Editor symbols for debugging component it you wil 
not be using t 





Unreal Engine 4104 

















5. Ater the engine has installed, the Install Engine button wil change toa Launch 
Engine button. 








The Epic Games Launcher is the program that you need to start up the engine itse'f. t keeps a 
copy of all your projects and libraries in the Library tab. 


There's more. 


“Ty dounleading some of the free ibrary packages in the Library | Vault section. For that, 
lek the Library tem on the leftside, and scroll doum unti you see Vault, underneath My 
Projects. 


UE4 6 prst project 


‘Setting up a Project within UES takes a number of steps It is important to get your options 
correct s that you can have the setup that you ike, so carefull follow this recipe when 
‘constructing your rst project. 

Each project that you create within UEA takes up at least GB of space or so, so you should 


decide whether you want your created projects on the same target drive, or on an extemal or 
Separate HDD. 


How to do it. 


1. From the Epic Games Launcher, lick on the Launch Unreal Engine 4.11.2 buto. 
Once you are inside the engine, an option to create a new project or load an esting 
one wil presents itself 

2. Select the New Project tab. 

3. Decide whether you wil be using C++- t code your project, or Blueprints exclusively: 

1. if using Blueprints exclusively, make your selection of a template to use fom. 
te Blueprint ab. 

2. Wusing C++ in addon to Blueprints to construct your project, select the 
project template to construct your project based on the C++tab. 

3. Wf youe not sure what template to base your code on, BASIC Code is an 
excelent starting paint far any C+ project (or Blank for a Blueprint exclusive 
project 
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4. Take a look atthe three icons that appear beneath the template listing. There are 
three options here to corte 
1. You can choose to target Desktop or Mobile applications. 


2. You have an option to ater the quality settings (the picture of a plant with 
magi) But you probably dont need t altar these: Te quality settings are 
reconfigurable under Engine | Engine Scalability Settings anyay. 

3. The last option ie whether to include Starter Content with the project or not- 
‘You can probably use the Starter Content package in pour project has 
some exellent matenas and textures ava lable within iÈ 


B 


Select the drive and folder i mhich you wil save your project. Keep in mind that each 
project is roughly GB in size, and you wil need at least that much space on the 
estimation ave 

5, Name your project Preferably name something unique and specie to what you are 
planning on creating. 

T, Hi Create. Both the EA Editor and Visual Studio 2015 windows should pop up, 
enabling you to edt your project. 


Inthe future, keep in mind that you can open the Visual Studio 2015 
Solon via ane af the two folowing methods 
= Via pour lacal Fle explore. Navigate to the raot of where your project 
is stared, and doublecick on the Pray ect Na me. sia fie 
= From UES, cicon File Open Visual Studio. 








UE4 ð creating y ] 


‘Creating levels in UES is easy and fcitted by a great UL all around. In this recipe, well 
line basic editor use and describe howto construct your rst level once you have your rst 
Project launched. 


Getting ready 


Complete the previous recipe, UEA - First Project Once you have a project constructed, we 
can proceed with creating a lee 


r þrst lev 





4 


Chapter 





1, The default level that gets set up when ou start a new project wi! contain some 
default geometry and scenery. You dan need to start wth this starter stuff, however. 
Ifyou dont want to build from it, you can delete it, or create a new level 

2. To create a new level, cick File | New Level.. and select to create a level with a 
background sky (Default), or without a background sky Empty Level 


! 


1 you loaded the Starter Content on your project's creation (or some other content), 
than you can use the Content Browser to pull content ino your level. Simply drag and 
rop instances of your content rom he Content Browser into the level, save, and 
launch them. 


4. Aid some geometry to your level using the Modes panel Window | Modes). Be sure 
ta click onthe picture of a ight bulb and cube to acces the placeable geometry You 


can also add lights via the Modes tab by clicking on the Lights subta onthe left- 
and side of the Modes tab. 


FACER. 
[eee od 





The Modes pane contains two useful tems fr ievel onstruction: 
some sample geometry to add cubes and spheres and the) 
"ellas a panel ful of ts Try these cut and experiment to begin 
laying out your ev. 





ith UE_LOG 


Logging is extremely important for outputting internal game data. Using log toos lets you print 
information into a handy tle Output Log window in the UES editor. 





is 
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Getting ready 


Wren coding, we may sometimes want to send some debug information out to the UE log 
window. This s possible using the UE_LOG macro. Log messages are an extremely important 
ard convenient wayto keep track of information in your program as you are developing E- 


How to doit... 


1. In your code, enter a line of code using the form: 
UE _LOGiLosTenp, Waralag, TEXTU Sene warning message") 1; 


2, Tum on the Output Log inside the UEA editor to see your log messages printed in that 
window as your program is running. 





The UE_LOG macro accepts a minimum of three parameters: 
= The Logcategory (we used LogTe ne here to denote a log message in a temporary 
es) 


= The Log evel (we used a warning here to denote a lag message printed in yellow 
aming text) 


sting for the actual text of the og message itsel 


Do not forget theTEXT| ) macro around your log message tet! t promotes the enclosed teit 
"o Unicode (t prepends an L) when the compler ls set to un with Unicode on. 
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UE. 106 also accepts a variable number of arguments, ust ike pri at (fromthe C 
Prágramming language. 





fluat fleatvar = 3.71 

Hitring fstringkar = ^as fstring vari abl 
YE. oG{Logtenp, Matning, TEKTI Test, M M 5), Lata 
star tri gar d 











There wil be an asterisk justbelore Fst r| ng varlables when using UE, Li 
the FString to a regular stye TCHAR pointer. 


to dereference 





THAR is ususlydetned asa erable pe aber e, if Unicode is being 
diy used in the compile, the TCHAR resolves to ue har ,¢ |f Unicode ts 
VQ, Giforiiersuien UAI CODE noted then TCHAR estes a 
simply char. 





Dont forget to clear your log messages after you na longer need them from the source! 
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king an FString from FStrin 
variables 








When coding in UES, you often want to construet a string frm variables, This is pretty easy 
using the String: ori ntf orfStri ng: : Format functions 


Getting ready 


For this, you should have an exiting project into which you can enter some UES Ci code. 
Putting variables into a sting is possible via printing. I may be counterintuitive to print into a 
string but you cant just concatenate variables together, and hope that they wil automatically 
Convert to string, as in some languages such as JavaScript 


How to do it.. 


A. Uslnge tring: : Pri ntf 
1. Consider the variables you'd like printed into your string. 


2. Open and take a look ata reference page of the pri nt format specifiers, 
suchashtt:(/ea. cppref erence. com w Coplioj ci pri eT 
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3. Tycode such as the following: 


Hitring rame = “Tia 
String string = Fstringi: Print| TEXTE “Name = 86 ana 
sg |. name, mana | 


Notice howthe preceding code ioc uses the format spociers precisely as the 
aditional pri at function does. nte preceding example we used t to place 
‘a string in the formatted string, and & to place an integer in the formatted sting, 
Different forrat spacers exist or different types of variaties, and you shouid lock 
Mem up on aste such as cppreerence com. 


2. Ung Stri ng: : For rat) Write code in the following form: 


ini mana = dst 

Tarraye FStriagFormatArg > args 

args.Addt Pstringtormatargi name ) | 

args Addl Fstringtormatārgi mana ) | 

Fstring string = Strings formi TEXTI “Hane = {0} Was 





(Y pam d 
UE Losi Legtemp, warming, TEXTU “Your strisg: e J 


Wah ESti ng: : Ferma) instead of using correct femrat specipers, we usesimpie 
integers anda TAr tay offers ngFar mat Arg Instead. Thefztriniferestirg 
helps Fst ri ng: Format C] deduce the type of variable to put in the sting 


n GitHub 6 getting 





Avery important thing to do for your project as youre developing it is to generate a timeline 
history as youre working, To do so, you need to back up your source code periodically. A great 
ool for doing so is Git. Git allows you to park changes [commits into a repository oniine on 
remote server so that your code's development history is documented and preserved on 
that remate server. If your local copy gets damaged somehow, you can always recover from 
te online backups. This timeline-tistory of your codebase's development is called Source 
Control. 


Getting ready 


There are a couple of free services that offer online source backups. Some of the free 
allemativs for storing your data include: 
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Visualstudlo.com: limited private sharing of your repository 
thub.com: unlimited publc sharing of your repastories 


Msualstudio com is great far when you want same privacy for your project for free, while 
GitHub is great when you want to share your project with lots of users for free. Visualstudio. 

‘com atsa ofes same very good workboarding and planning features, which we wil use later 
in this tese (GitHub also offers a competing Issue Tacker, which wel discuss later on as well. 


The website you choose depends mostiyon haw you plan on sharing your code: In this text, we 
vill use GitHub for source code storage, since we need to share our code with a large number 
of users (yu) 


How to do it. 


1 


‘Signup fora GitHub accountat ht tps: | ai taub. com, Sin into your GitHub 
account using the Team Explorer menu (view | Team Explorer. 

Once you have the Team Explorer open, you can sian inta your GitHub account using 
the button that appears in the Team Explorer windon, 

Ater youve signed in, you should gain the capabilty to Clone and Create 
Tepostores, These options will appear right undemeath the GitHub menu in the 
Team Explorer, 

‘From here, we vantto create our hrst repository Ht the Create bution, and name 
our repostoryin the window that comes up. 


When cresting eur projet. take care to sect the VisualStudlo option 
Ey fromthe gi 1 gaor e options mena. This wil cause Gitto inre ihe 
| Visual Studio speci fles that you dont want included in your repository, 
such as he Buld and Release directories. 


Now you have a repository! The repository is initialized on GitHub, We just have to put 
some code into it 


Open up the Epi Games Launcher, and create a project to put into the repository. 


Open the C+ project in Visual Studio 2015, and fight cic on Solution. Select Add 
Solution to Source Control Irom the cortex menu that appears. The dialog that 
appears wil ask whether you want to use Git or VC. 


I you use Git for your source contro, then you can host 
on ether github com or Vastu com. 
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B. After you add Git Source Control to the project, take a look at Team Explorer again: 
From that window, you should enter a brief message, then click on the Commit 
button. 


Gt repositories are importar for backing up copes of your code and project Hes as your 
project evolves. There are many commands within Git to browse the project history (ny the 
Gi GU tonl}, sce what changes youve made since the last commit (gi t 4], oF maie 
backward and forward though the Git histary(gi t checkout cemeit-hash- id) 


Project management on GitHub ð using the 


Tracker 





Keeping track of you projects progress, features, and bugs is extremely important. The GitHub 
Issue Tracker wil enable ou to do this 


Getting ready 


Keeping track of your project's planned features and running issues is important Gub 
Issue Tracker can be used to create lists of features you'd like to add to your project as well 
as bugs yu need o a sore time inthe fiture. 


How to do it... 


1. Tack an issue to your Issue Tacker, rst select the repository that oud Ike ned 
by going to the front page of GitHub and selecting the Repositories tab: 





io 
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From your repostorys homepage, select the Issues tab under your repository To add 
an issue to track, click the New issue button in the lowesight comer of the screen, 
as seen In the foiloning screenshot: 


2 





lo — 











When adding our issue, tis good practice to detail it as much as possible. Including 
screenshots and diagrams inthe features or bugs you posti highly recommended, 
as it documents the ssue much better, and parks important information and a good 
esciiton nto your issue Tracker. Dragging and dropping images into the tx editor 
window automaticaly uploads a copy of the image to thu’ own cloud server, and 
Mhe image will appear nine in the Issue, as shown in the flowing screenshot: 


ee =) 




















The boxinto which you enter the description of your bug or feature supports 
Markdown. Markdown is a simpibed HTMLtke rrarkup language that lets you quidáy 
‘rte HTML ke syntax wth ease. Examples of some markdown Syntax are as follows: 
4 eati ngs 

te tirs heating 
[reris nte Tits res. com 





cade (intentet by € spices], preceded ay a blast tine 
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Wp tnt a more abaut rls a hc 
R outhttps:! fdati ngtirebal i net/ proj ects) 


5. You can further mark the issue as either a bug, enhancement (feature), or anyother 
label you like. Customizing labels is possible via the Issues | Labels Iink: 








D EF 











6, From there, you can edit, change the colar of or delete your abes. I deleted all the 
stock labels, and replaced the word enhancement with eat ure, as seen in the 
following two screenshots 









































3. Once youve fully customized your labels, your Gub Issue Tacker is much easier to 
navigate. Prioritize issues by tagging with the appropriate labels, 


GitHub Issue Tracker la fantastic way to track bugs and features in your project Using it not 


only organizes your eran but also rraintains an excellent history of the work done on the 
project. 


See also 


= You should also check out the Wiki feature, whieh allons you to document your 


source code 





Highdevel management of your project is usually done using a planning tool. GIHub sue 
Tracker may meet your needs, but lf you're loking for more, Micrasoft Visual Studi Team 


‘Services oes planning tos far Scrum and Kanban stye programming assignment of tasks 
(Features, Bugs, and so on). 


Using this tool is a great way to organize your tasks to make sure things get done on time, 
and to get used to an Industrial standard warkjow When you sign up for Visual Studio's 
Community Edition during setup. your account includes Tree use of these tol 
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How to do it. 


inthis section, wel describe haw to use the Warkboard feature on Visualstudiocom to plan à 
few simple tasks. 


1. To creste your own project Workboard, go to your account at Vsualstudi com. Log 
and then select the Overview ab. Under Recent projects & teams title, select the 


New ink 














2. Add a Project name and Description to your project Ater you've named your project 
Ive named mine Vor boa rs cick on Create project, You will walt a second or 
two for project creation to complete, then hit the Navigate to project button inthe 
net dalog. 





Team project information 


























Qaptart 





3. The nest screen that is shown allows you to navigate to he Workboards area. Click 
on Manage Work 





4. The Manage Work screen is a Kanban styled read priortized) task queue of things 
"o do in your project You can hit the New tem button to adá new tems to yout ik of 
things to do. 
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Each lem on your Board's backlog is called a User Story. A User Story ls an Age software 
development term, and each User Story s supposed to describe a need ofa particular end 
ser. For example, in the preceding User Story, the need is o have visual graphics, and the 
User Story describes that graphies (sprites) must be created to satisfy this user requirement. 


User stories wll often hane a speci format: 


[sé jaa oen ni that dares ] 
[SS steers ] 


‘onthe Workboar, yout have a bunch of user stories. Ihave placed a fes 
so we can play with them. 


user stories earlier 





Once your board is Bed vith user stories, they wil al sitin the New vertical cour. As you 
start work on ar make progress on a particular User Story, you can drag it horizontally fram 
New to Active, then pally to Resolved and Closed when the User Story ie complete. 
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From the Scrum point of ew, a User Storyis grouping of tasks that need to be done, A group 
of user stories can be collected into a Feature, and a group of Features can be gathered 
together into whats called an Epic. VeualStude com organizes User Story creation very well 
So that its easy to construct and plan the completion of any particular task (user story). In this 
‘cig, well describe how to assemble and put together user stories. 


Project management on Vi 
constructing user stories and ta: 











= 








Getting ready 


Every item entered into VsualStudio com's project management suite should always be a 
feature that somebody wants to be in the software. User story creation & a fun, easy and 
exciting way to group together and mete out bunches of tasks to your programmers as work 
"a be one, Log in to your VisualStusin.com account now, eeit one of your projects, and begin 
using this feature. 


How to do it. 


1. From the VsualStudio.com Team Services landing page, navigate to the project into 
hich you want to erter some new work t be done. Al of your Projects can be found 
if you click on Browse under the Recent projects & teams heading. 











2. Select the project that you want to work with and hit Navigate. 


3. Tasks inside Visuatstudio.com take place inside of one of the three categories ot 
super task: 


User Story 
E Features 
© Eples 
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(User 
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ent Tels 


User Stores, Features, and Epics are just organizational units for work. An 
Epic contains many Features. A Feature contains many User Stores anda 
User Story contains many Tasks. 

By default, Epics are nat shown. You can display Epics by going to Settings 
Ihe gear ican on the right side of the screen). Then navigate to Genera! | 
Backlops Under the section that says See only the backlogs your team 
manages, select to display all three favors of lacks. Epics, Features, and 
Stories, 


are now four navigation steps to perform belore you can erter your st task 
Story into the Backlog: 


From the menu bar at the top, select WORK. 
Then, in the submenu that appears on the WORK page, select Backlogs. 


On the sidebar that appears, click on Stories. 
From the panel on the righthand side, select Board. 





[* 


5. fom 
User 


Backlog s the set of User Stories and Tasks that we have yetto 
complet You might think, "ve brand new tasks really entered int a 
‘Backlog? Wars ret! are ready befand! The pation of Sous 
terminaiagy seem to imply teriwing with wort”. 


the panel on the righthand side, hit New tem, and Hl in the te for your new 
Story tem. 
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5. Click on the text of the User Story card, and in the þeids for Assignee, the 


Iteration that it a part of, Description, tags, and anyother peld of the Details 
‘ab that you want to explore. 


7. Mot we break down the overall User Story into a sertes af achievable tasks. Hover 
over your new User Stary item unti the elipsis three dots... appears. Click on the 
ellipsis, and select +Add Task, 

8, Listthe details of completing the User Story in the series of Tasks. 

3. Assign each Task to: 

eo An Assignee 
& An eration 


‘Simply put an eration is realy just a time period. Attha end of each 


eration, you should have a deerat, testate piece cf sofbare 
J) completed tration is a ime period trat refers to producing et another 


version of your amazing software (for testing and posse release}. 


10. Continue adding Tasks to the project as the project develops features to complete 
and buss lob 


How it works. 





Epics contain a number of Features, Features contain a number of User Stories, and User 
Stories contain a number of Tasks and Tests 


Epic Battleships 
Feature Attacks Feature Motion 
User Story Vs Building User story Patrol 





m [wm 
Pee 











‘lof these items are assignable to a User [an actual human), and to an tration time 
Bero) for both assigning responsibilty and scheduling a task. Once these are assigned, 
"he task shouid appear In the Queries tab: 
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E 


Delaied stens to download the code bundle are mentioned in the Preface of 
this took Please have a lok 

The code bundle far the book is also hosted on GitHub at ht t ps: | 

ai ING. comi Packt Publ sbi ngl Unreal- Engine- €- Seri pti ng 
i th. CPI usi us- Copi bont. We also have ther code bundles from 
butch catalog af books and videos avañabke at ht t p5- [gi CUB. com 
Packt Puoi SMi ngf - Oreck them out! 





Creating Classes 


This chapter focuses on how to create C++ classes and structs that integrate well with the 
UES Blueprints editor. These classes are graduated versions of the regular C+ classes, 
and are called UCLASS. 


di, AUCLASS isjust a CH class with a whale tof UEA macra decoration 
ÜR) on top. The macros generate additional C++ header code that enables 
V integration wth tne UES Editor te 

Using UCLASS isa great practice. The UCLASS macro if conbared corectly can possibly 
maie your CLASS Blueprintable. The advantage of making your UCLASS Blueprinable i 
thatit can enable your custom C+ objects to have Blueprints visually editable properties 

PROPERTY ) uith handy Ut vádgets such as text peld, siders, and model selection bores. 
You can also have functions (UFUNCT! ON) that are callable from within a Blueprints diagram. 
Both of these are shown in the following screenshots: 











On the left, two UPROPERTY decorated class members (a UText ur e reference and an F Col or] 
show up for editing in a Cet class's Blueprint. On the right, a C++ function Get Kame marked as 
B uepr i nt Cal asi e UFUACTI Ok shows upas callable from a Blueprints diagram. 





r 
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MR. TEEN ti ree at nel aired or 


Code generated bythe UCL ASS macro wil be located ina CI ass Kame 
CLASS header CI ss lace, h 


The follwing are the toples that we wil cover in this chapter 





Making CLASS - deriving from UOb e 
= Creatinga useredtable UPROFERTY 
© Aecessinga UPROPERTY from Blueprints 

‘+ Specyng a UCLASS as the type ofa UPROP ATY 

= Creatinga Blueprint from your custom UCLASS 

+ IntantatingUObj ert derived classes (Const ract Object <> and Kendi] ert el 





© Destroying ob] ect derived casses 
= Creatinga usTaucT 

Creating venum 

= Creatinga UFUNCTI ow 





You wil notice that the sample objects we create in this class, even when 

) Blueprint, wil not be placed in vels. That is because in order la be. 

Ml) placed nei, your Ce class must derive from the Ac tor bas 
below it See Chapter 4, Actors and Components for further det 


Introduction 


to wite and manage once you know the pattems, The 
Y UCLASS „ar to create a UPROPERTY or FUNCTI ON, Is 
Sery consistent. This chapter provides recipes for common UEA coding tasks revolving around 
Basic UCLASS derivation, property and reerence declaration, constuction, destruction, and 
general functionality 











Making a UCLASS ð deriving from UObject 





with C+, you can have your wm code that comple and runs as native C++ 

Gode, with appropriate calls to new and de! ex to create and destroy your custom objects- 

Native C++ code is perfectly acceptable in your UES project as longas your rev and ei ete 
tin your Ces code 
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‘You can, however, also declare custom C++ casses, which behave like UEA casses, by 
declaring your custom C+ objects as UCL AS5. UCLASS use UE4's Smart Pointers and memory 
management routines fr allocation and dealiocation according to Smart Pointer rules, can be 
loaded and read by the UES Editor, and can optionally be accessed from Blueprints. 





Note that when you use the UCLASS macro, your CLASS objects creation 
and destrucion must be completely managed by UEA: you must use 





te destroy ine object nat the C++ native keyword el et e). How to create 
and destroy our 908] se dervatue classes is outined nthe rstantatg 
object derive classes [Constuet0Bject > and NewObject | and 
Destroying UObjectserned classes sections later in tnis chapter. 


Getting ready 


In this recipe, we wil outline how to write a Ce cass that uses the UL ASS macro to enable 
‘managed memory allocation and dealacaten as well as to permit access fom the UEA Editor 
and Blueprints. You need a UEA project into which you can add new code to use this recipe. 


How to do it... 


To create your own ohj ect derivative class, follow the steps below: 


1. From your running project, select File | Add Cie Class inside the UEM Edito 


2. In the Add C++ Cass dialog that appears, go to the uppersight side of the window, 
and tick the Show Al Clases checkbox 


rm 
Choose Parent Class 








xL 
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3. Create alcLass by choosing to deriv from the bj ect parent class. Ob) ect is 
"he roat af the UES hierarchy. You must c the Show AlI Classes checkboxin the 
uppersight comer e tis dialog for the D ect class to appear In the list ve 

4. Selects) ect (top af the hierarchy) as the parent class to inherit from, and then 
ick on Next. 


Note that athough Obj ect wil be witten in th dialog box in your C++ 
tode, the C++ class you wil dering fram is actualy UOb ect weh a leading 
Uppercase U. This is the naming convention af UES: 

UCLASS deriving om Ob] ect (ona branch atherthanact or ) must be 
namaa with a leading U. 

CLASS dering fom Actor must be named with a leadingA (Chapter d, 
Actors and Components). 

Ch classes that are nat UCL ASS ) deriving from nothing do nat have 

a naming comentan, but can be named with a leading F (far sample, 
Fasset Dat a} prefered 

Direct derivates ot UOB] ect wil not be eel placeabl, even they contain 
visual representation slements such as USt cee be you wan to 
lace your abject inside a UE level you must at least derve from tne Act or 
ass or beneath itin the inhertance hierarchy: See Chapter 4 Actors and 
Components Tar haw ta derue rom he Ac t a class Tor a level placeat 
object. 

“This chapters example code wl nat be placeable in he level, but you ean 
create and use Blueprints based on the C++ lasses that we writ n hs 
thapterin the UE Ear 


5. Name your new Ob ect derivative something appropriate for the object type that 
ou are creating cali mine User Prati | e. This comes off as Viser Os] ect In 
the naming f the dass in the C+ Be that UA generates to ensure that the UE 
conventions are followed [C++UCLASS preceded with a leading U), 

5. Goto Visual Studio, and ensure your class e has the folowing or 
teragm once 





oct eae oo] ect. hh |) For deriving fram Ub] ect 
acl eae “Usertratite generates." J| Generates cote 


|) UCLASS macra options sets thie Cie elass to be 
|) Alasprintabie within tee UEC Editor 
CLASSI El eprintable | 











clase CHAPTERD APL UUserPeofile : public UObj eet 
t 

sENERATED, soov) 
} 


T. Compile and run your project You can now use your custom UCLASS object inside 
Visual Studio, and inside the UEA Editor. See the following recipes for more details 
on what you can do with it 


{EA generates and manages a sonibcant amount of code for your customUCLASS. This code 
is generated as a result ofthe use of the UES macros such as UPROPERTY  UFUNCTI ON. 

and the UCLASS macro sel The generated code is put int User Proti | e. generat ed. h. 

You must include the UCLASSNANE, gener at ed. h HewihtheUCLASSHANE. h He for 

compilation to succeed. Without including the UCLASSNAME. gener at 26.» He, compilation 
wouid fail The UCLASSNANE. generated. h He must beindudedas the ast ncl ude in 

thelistof ti ncl ude IDUCLASSRANE. h 





Rig [Wong 
erage ane wapa 





#iaclude “object. 





tinel ude “obj ee 











finclode ‘Texture, h Hacuse 
JI CORRECT: generated. Last | "userProrile. generated. ht 
te 1| RONG: NO INCLUDES AFTER 
Hinclude GENERATED. FILE 

FUSE Prati le. generates. morer "Textarea! 





The eror that occurs when a UCLASSNANE. gener ated. h Hes notincuded as ina listo 
Includes is as flows 


>> #include found after generated b file - the -generated.h file 
Shoal always be the Tast Winch ade 1a a tender 
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There's more. 


There are a bunch of keywords that we want to discuss here, which madifythe waya UCLASS 
‘behaves, AUCLASS can be marked as folus: 


Blueprint a1 e:This means that you want to be able to construct a Blueprint 
"rom the Class Viewer inside the UES Editor (when you right-click, Create Blueprint 
Class. becomes avalabe) Without the 31 uzpr 1 nt abl = keyword, the Create 
Blueprint Class, option wil not be avaliable for your UCL ASS, even if you can 
Frei fromwithin theClass Viewer and right-click on IE 





The Create Blueprint Class... option is only availabe f you specly£t uepri ntal e 
in your UCLASS macro denition. If you do rot specify sepr i ntabl e, then the 
resultant UCLASS wil tbe! vepri nt ble 

Blueprint Type: Using this keyword implies that the UCLASS is usable as 
‘a variabile from another Blueprint. You can create Blueprint variables fom 
the Variables group in the lefthand panel of any Blueprints EventGraph. If 
Not Bl uepr st Type is speciped, then you cannot use this Blueprint variable type 
as a variable in a Blueprints diagram. Right-cicking the UCLASS name in the Class 
Viewer will not show Create Blueprint Class... in its conta ment: 








Caper 


BeyUCLASS thathave2! veor nt Type specibed can be added as variables to your Blueprint 
lass diagrams list of variables. 





‘You may be unsure whether to declare your C++ class as a UCLASS r not Itis really up to 


You. 1f you Ike Smart Pointers, you may br that UC LASS not only make for safer code, but 
AG make the entire code base more Coherent and mare consistent. 


See also 


^ To add addtional programmable UPROPERTY to the Blueprints diagrams, see the 
Creating a user editable UPROPERTY section below For details on referring to 
instances of ourUCLASS using appropriate Smart Pointers, refer to Chapter 3, 
Memory Management and Smart Pointers. 


UPROPERT 





Each UCLASS that you declare can have any number of UPROPERTY declared forit within it 
Each UP AOP ERTY can bea visually editable bl, or some Blueprints accessible data member 
ofthe UCLASS: 


‘Tere are a rarber of qualibers that we can add to each UPROPERTY, which change the 
vay it behaves rom within the UEA Editor, such as di t Any there (screens fom which the 
UPROPERTY can be changed), and i uepr i nt Rea dW ite (specyng that Blueprints can 
both read and write the variable at anytime in addition to the C++ code being alowed to 
doso). 


Getting ready 


To use this recipe, you should have a Ce project into which you can add Ci» code. In 
addition, you shouid have completed the preceding recipe, Making a UCLASS - deriving 
from UObject 


How to do it... 


1. Add members to your CLASS declaration as follows 


UcLASSI sluepritable | 
Clase CHAPTERI API UUserProfile : public UOb| eet 
( 





SeneraTen soov) 
public 
PROPERTY Es tAnywhere, Blusgri eReasmrive, Category 
Stats 
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PROPERTY ESI tAyahere, Blueprint he 
i 


2. Create a Blueprint of your ect class derivative, and open the Blueprint in the 
UE edior by double-clicking i from the object browser 

3, You can naw speci values in Blueprints for the default values af these new 
UPROPERTY pals 














4. Spectyperinstance values by dragging and dropping a few instances of the Blueprint 
lass into your level, and editing the values on the object placed foy double-clicking 
on them 


The parameters passed to the UPAOPERTY( | macro specify a couple of important pleces of 
Information regering the variable. In the preceding example, we speciped the following 
dj t Any uher e: This means thatthe UPROPERTY } macro can be edited either 
‘ect ram the Blueprint, or an each instance ofthe UCI ass objectas placed 
în the game level. Contrast thie with the following: 
& Edi t Det aal t snl y: The Blueprints value i editable, but itis not editable 
on a perintance basis 
E Editi nstance0nl y: This would alow editing of the UPROPERTY | macro 
in the gameieve instances ofthe UCI ase object, and not on the base 
blueprint set 
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Blueprint endi te: This indicates that the property is both readable and 
writeable from Blueprints diagrams. UPROPERTY( | with@luepri ot Readlk i te must 
be pubiic members, otherwise compilation will fail. Contrast this with the folowing: 


€ Bl vepri nt ReacOn! y: The property must be set ftom C++ and cannot be 
changed trom Blueprints 








= Categor y: You should always specifya Cat egor y for your UPROPERTYI ). The 
ät egor y determines which submenu the UPROPERT YC} wil appear under in the 
property editar. AI LPROPEKTYL) speciped underCat egor y =St ats wil appear in 
"esame Sta! s area în the Blueprints editor. 


See also 


= Acomplete PROPERTY listings located athtt ps: ace. unreal engine. com 
Tatest] ITI Programm ng/ Unreal Architecture] Reference) Properties) 
Speci Fiers} i nden. ht el. Ghe ita browse 








UPROPERTY from Blueprints 





Accessing a UPROPERTY from Blueprints is fy simple. The member must be exposed 
ASA IPROPERTY on the member variable that you want o access from your Blueprints 
diagram. You must qualify the UPROP ERTY in your macro declaration as being either 
Blueprint ReadOnly or8lvepr i nt Read te to specify whether you want the 
variable to be either readable ony) from Blueprints, or even writeable from Blueprints. 


‘You can also use the special value BI vepri at Det aul ts Onl y to indicate that you only 
want the default value (before the game starts) to be editable from the Blueprints editor, 
Blueprint Def aul tsn! y indicates the data member cannot be edited from Blueprints 
at runtime. 


How to do it. 


1. Create some UObj ect -derivative class, specifjingboth BI uepr i nt abl e and 
Blueprint Type, such as the following: 
UCLISSI Blueprintable, al eepri attyse ) 
class CHAPTERD API UUserPraile : publie UOb| eet 
t 
sENERATED, eoori 
public 


UPAOFERTY( Es tAnywhere, Blusgri Reasmrive, Category 
Stats 


string ane 
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‘The dl uepri nt Type declaration in the UCLASS macro is requred to use he. 
UCLASS asa type within a Blueprints diagram. 


2. Within the UES Editor, derive a Blueprint class rom the C+ class, as shown in 
Creating a Blueprint from your custom UCLASS. 

3. Create an instance of your Blueprint derived class in the UES Editor by dragging an 
instance from the Content Browser into the main game world area. should appear 
asa round white sphere in the care world uriess youve speciped a model mesh 
forit 

4. Ina Blueprints diagram which allows function calis (such as the Level Blueprint, 
accessible via Blueprints | Open Level Blueprint), ry printing be Name property 
af your Warrior instance, as seen in the flowing screenshot 

















Navigating Blueprints diagrams is easy Rightetick and dragto pana 
Ji + Drag to zoom. 





UPROPERTY are automatically witten Get [Set methods for UEA classes, They must not 
be declared as pr į vate variables within the UCL ASS, however. I they are nt declared 
aspubli c oror ot ected members, you wil geta compiler error of the form: 





>> sluspriatReadtrite sheul nat be ased on private members 
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UPROPERTY 





‘So, youve constructed some custom UCLASS intended for use inside UEA. But how do you 
inetartiate ther? Objects in UES are reference counted and merroryerenaged, so you haud 
not allocate them directiy using the C+- keyword new. Instead, eu have to use a function 
Called Construct Oh] ect to instantiate yours] ect derhative. Const ruct Obj ect doesnt 
Just take the C++ elass of the object you are creating, also requires a Blueprint class dete 
Gf the Cer lass (a UCI ass* reference) AUCI ass* reference s just a pointer to a Blueprint 


How do we instantiate an instance af a particuiar Blueprint from C-code? C code does 
not, and should not, know concrete UCLASS names, since these names are created and 


‘edited in the UEA Editor, which you can only access alter compilation. We need a way to 
Somehow hand back the Blueprint class name to instantiate to the C++ code. 


The way we do this is by having the UEA programmer selectthe UC ass thatthe C++ code 
is to use fom a simple drop-down menu isting all the Blueprints available (derived from 
a particular C+ class) inside the UEA Edtor To do this, we simply have to provide a user- 
editable LPROPERTY with aTSubcl ass 0t «CesCl ass Na m> ped variable, Aternatively, 
ou can use FStringCl ass ef ererce to achieve the same objective. 





‘This makes selecting the UCLASS in the C+ code is exactly like selecting a texture to use. 
UCLASS shouid be considered as resources to the C++ code, and their names should never 
be hardcoded into the code base. 


Getting ready 


in your UEA code, youve often going to need to refer to dillerent UCL ASS in the project 
Fer example say you need to know the UCL ASS of the player abject so that ou can use 
Spann0b| ect In your code on i Specifying a UCLASS fom C+ code is extremely awkward, 
because the C+ code is not supposed o know about the concrete instances of the derived 
UCL A55 that ware created in the Blueprints editor at all Just as we dont want to bake specs: 
asset names into the C++ code, we dont want to hardcode derived Blueprints class names 
into the CH code 





So we use a C++ variabile (for example, UCI ass 0f PI ayar | and select that froma 
‘Blueprints dlalog In the UE editor, You can do so usinga TSubc| a=! member oran 
FstringC! asset erence member, as shown in the flloving screenshot 
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How to do it. 








1. Navigate to the C+ class that you'd ike to add the UCLASS reference member to. 
For example, decking out a class derivative with the UCLASS of the playeris faily easy. 
2. From inside a UCLASS, use code of the folowing form to declare a UPROPERTY 
that allows selection ofa UCI ass (Blueprint class) that derives from UOb ect 
in the hierarchy: 
ucussi 
Clase CHAPTERD APL UUserProfile : public UObj eet 
f 
UPAOFERTY(EsitAnyahere, BlueprintReadurite, Category = 
dni 
Tsubel assot «UObj eet» UCIassOt Player; Ji Olsplays any 
classes 
JI deriving from Uobject in a dropdown menu in Biueprints 
J1 Displays string sames of UCLASSes that derive from 
J| the Gameliode Cos base class 
UPROPEATY( EditAnyuere, metast Netaci ass=" Gamelode"). 
Category = unit | 
Fstelagclasshet erence UCIassGameliode: 
I 
3. Blueprint the C+ css, and then open that Blueprint. Click on the drop-down menu 
Beside your UCI ass 0f P1 ayer menu 
4. Select the appropriate UCI ass Of P ayer member from the dropdown menu of the 
ted Ulass. 
How it works. 
TSubclassof 


TheTSubel assOt < > member will allow youto spec a UCI ass name usinga drop- 
down menu inside the UEG editor when editing any Blueprints that hae TSubc! ass < > 
members 


FStringClassReference 
‘The et ati ass tag refers to the base Ct class from which you espect the UCI ass Name 
to derive. This mits the drop-down menus contents to only the Blueprints derived from that 
Cet class, You can leave he et Class tag out if you wish to display all the Blueprints in 
the projet. 
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Bveprinting is just the process of dering a Blueprint class for your C++ object. Creating 
Blueprint derived classes fram your UE objects allows you to ed the custom UPROFERTY 
\isually inside the editor. This avoids hardcoding any resources into your C++ code. In addition, 
in order for your Ces class to be placeabie within the ewel, it must be Bluprinted rst But this 
is only possibie ftne C++ class underlying the Blueprint is an Act or casservate. 


tn ead resources (such as teures) using 





Ci cade) are generally discouraged, however: Providing an editable 
valve ina UPROFERTY( | and loading from a proper concretely typed 
asset reference a much better practice. 





Terisa 
FStringAsset References and Stati cLoadObj ect These 
eG. tenance Py batissa puih tea 


[Getting ready | 


‘You need to have a constructed UCL ASS that you'd ke to derive a Blueprint class from (see 
"he Making a UCLASS - deriving fram UObject section eater in this chapter) in order to falow 
is recipe. You must have also marked your UCLASS as sepr i stable inthe UCLASS 
macm for Blueprinting to be possible inside the engine. 





S) AU ect derived class with the meta keyword B! uepri nt abl e 
QQ) intheucLASS macro declaration wi be vege! at ble 


1. ToBlueprint your User Prof i| e diss, brst ensurethat UCL ASS has the 
Ei uep ti taal e tagin the UCLASS macro. This should loo as follows: 








ASSI Slueprintable | 
class CHPTERL API UUserPratile : publie Uab] eet 


2. Comple andra 





your code. 





m 
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3. Find the User Prati I e C++ class inthe Class Viewer (Window | Developer Tools | 
Class Viewer). Since the previously created ICLASS does not derive fram Ar ar, 


IrdyourcustomUCL as you must turn ff Filters | Actors Oniy in the Class Viewer 
(which s checked by deta 





Tum otf the Actors Only check mark to display all the casses in the Class Viewer. 
yo dort do this, then your custom C+ class may not show! 


Keep in mind that you can use the small search bor inside the Class 
| Viewer t easly fnd tne Us =F ProF i) e tlass by starting to pe fn | 
4 





Find yourUser Prot i| e class in the Cass Viewer, rightclick on it, and create a 
Blueprint rom it by selecting Create Blueprint. 

5. Name your Blueprint: Some prefer to prebxthe Blueprint dass name with BP. 
You may choose lo folo ths convention or nat, just be sure to be consistent. 

5. Doublecickon your new Blueprint as it appears in the Content Browser, and take a 
Took atit. You wil be able t eat the Name and Emal pelde foreach iser Fr af = 
Blueprint instance you create. 


Any Ctt class you create that has hes vepr i nt ab e tagin its UCLASS macro can be 
Blueprinted within the UES editor A Blueprint allows you to customize properties on the 
Cè class in the visual GUI Interface of UEA. 








ived cla: 
and NewObject 





‘Creating class instances in C++ is traditionally done using the keyword new. However, UEA 
actually creates instances of ts classes internally and requires you to call special factory 
functions to produce copies of any UCLASS that you want to instantiate. You produce 
instances of the UES Blueprints classes, not the C++ class alone. When you create Ub] ect 
derived classes, you wil need to instantiate them using special UES Engine functions. 


The factory method allons UEA to exercise some memory management on the object, 


‘controling what happens to the object when itis deleted. This method allows UEG to track al 
references toan abject so that on object destruction, all references to the object can be easily 


Unlinked. This ensures that no dangling pointers with references to invalidated memory exist 
in the program. 


Getting ready 


Instantiating VOB) ect derhed classes that are not Act or class derivatives does not 


Use er! d: SpawnAct or < > Instead, we have to use special global functions named 
Construct On| sete >, or Newt} ect c > Note that you should not use the bare C+ 


keyword ne w to allocate new instances of your UEG UOB ect class derivatives. 
‘You wil need at least two pieces of information to properly instantiate your UCL ASS instance: 
+ ACH typed UCI ass reference to the class type that you would like to instantiate 
(Blueprint cass) 
The original C+ base class from which the Blueprint class derives 


How to do it. 


1. Ina globally accessible object ike your Game Mo de object) adda TSubcl assaf < 
YourCetCiassName > UPROFERTY(| to speciyand supplythe UCLASS name to 
our Ci code. For example, we ada the folowing two lines to our Ga ne Nove object 
PROPERTY Editanywhere, BlueprintAeadwite, Category = 
TSubel assOt User Proti e» UPB uepri nt CI assam: 


2 Erter the UE4 edor, and select your uc ass name from the drop-down menu so that 
eu can see what it does. Save, and exit the editor. 








Creating Casses 
3. Inyour Code pnd the section where you want instantiate theUCLASS instance. 


4. instantiate the object using Const r act Obj ect < > with the following formula 


on) ect Type" object = Construct aj ecte obj ectTyae >| 
Uclsesteference ) 


Foc example, using the User Profi object that we speciped in the last recipe, we would get 
code ike this. 


JI Get the GameMode object, shic has a reference to 
J the UClase mame that we shoul instantiate 
Achapter2GameNade “gm = Cast <ACapter 2GameNode>( 
eter) »éet Aut hdameModel |) 
I gm) 
D 
Uuser?roti let ob ect = ConstractOnj ecteluserPrati leot 
qe >Urbiuepriattiasshane | 
) 





I you prefer you can also use the Newdb j ect funcion as fallus: 
Urrati lat object = nendbl ect eUPrafil eal 
Getfransi entbackagel) 
vel assteference ) 


Instaating aU0s) ect class using Const rut Ob ect orKeudhj ect is simple. 
"evosj ect and Constr uct Object do neal the same ing instantiate an abject 
af Blueprint class type, and return a C+ pointer f the correct pe 


Unfortunately Newb ect has a nastyþrst parameter vhich requires you to pass 
GetTransientPackagel ) wih each cal. Construct Ohj ect does not require this 
parameter ith each cal. In addition, Const r uct Obi ect provides you with mare 
onstruction options. 





Do not use the keyword new when constructing your UEA UO ect detvatie! it wil not be 
property memory managed 


There's more. 


Newos| ect and Constr uct Obj ect are what the COP world calls factories. You ask the 
factory to make you the object-jou dont go about constructing it by yourself Using a factory 
Patte enables the engine tn easily rack objects as they are created. 


= 








oying UObje: 





Removing anyUOb ect derivative is simple in UEA. When you are ready to delete your 
ob; ect «derived class, we wil simply cal a single function Condi ti onal Begi nbestroyl]) 
‘on itto begin teardown. We do not use the native C++ del ete command on UOb ect 
eras. We shon tnis in the folonig recipe: 


Getting ready 


Youneedtocall Condi ti onal Begi aDest ray!) onanyunused Ij ect derived classes 
So that they get removed from memory Do nat call de et e on a UOb ect derived class to 
recoup the system memory. You must use the intemal engine provided memory management 
functions instead. The way to do this is shown nox. 


How to do it... 


41, Callabj ect! astance->Coadi ti onal Begi 





Destroyl| on your abject instance. 


2. Null ali your references toobi ect I nst ance in your lent code, and do not use 
bj ect nstance againafterCondi ti onal Begi Destroy] has been called 
ont. 


How it works... 


‘The Condi ti onal Begi nest roy) function begins the destruction process byremoving 
allitemal engine linkages to t This marks the object for destruction as far as the engines 
‘concemed. Te object is then destroyed some time later by destroying its internal properties, 
flowed by actual destruction of the object 


‘Mier Conditional Begi Destroy] has been called on an object, your (client) code must 
‘consider the object to be destroyed, and must no longer use it. 





‘Actual memory recovery happens some time later than when 
Condi ti anal Begi nDes tr oyl} has been called on an object There is a garbage collection 
‘routine that fishes clearing the menory of objects that are no longer referenced bythe gare 
programat bed irme intervals. The rre interval between grboge collector calls i ted. 
C:\Program Files (x86) Epic Games 1T éngi nel Config lBaseEngi nei ni, 
and defaults to one collection every GO seconds: 


gc- Ti meet weenPargi agPendi ngki 11 Obj ects 
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memory seems fw after several Condi ti anal Begi nDestray(| 
y you can trigger memory ceanup beating Get or <1) 
Y» 





Star cegar bageCol lect onl true) tofoce an intemal memory 
Seanu. 





Usually you do not need to worry about garbage collection or the interval unless you urgently 
need memary cleared. Do not call garbage colection routines too often, as this may cause 
unnecessary lag in the ame. 


a USTRU 





‘You may want i construct a Blueprints editable propertyin UEA that contains multiple 
members. The Col er edText ure stuet that we wil create in this chapter will alow you to 
oup together a teure and its clr inside the same structure fer inclusion and specipcatin 
in anyother Ioh ect derhative,8l veor int bl e class: 


TheF Col or edText ure structure does have the visual within Blueprints appearance as 
sheann in the pure above. 


“This is for ood organization and convenience of your other UCL ASS UPROPERTI ES 
‘You may want to construct a C++ structure in your game using the keyword str uct 


Getting ready 


UON] ect is the base class ofall UEA class objects, ile an FStr uct is just any plain old 
C+ sje struct. Al objects that use the automatic memory management features within the 
engine must derive from this class. 





Jh) anda C+ structs that C++ classes have defaultpri vat e members, while 
Q Shee datait publ) £ members a araga Ike Ca, bia nt o cat 


Ifyou’ recall trom the C+-+language, the oniy difference between a C++ class 
Tn Céja structs value ped, ule a class reference ped 
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How to do it. 


Well create a structure F Co! or edTextur e in C++ code to contain texture and a 
modulating color: 


1. GeateaHecol oredText ure. h in your project folder (notF Col oredText ur e) 
2, Col oredText ure. h contains the following code: 
toragm once 


include “Chapterd. e 
#inciede “Col oredTertare. generated. 


ustavert) 
Struct CHAPTERD_APL Fol oredTexture 


t 
cennarep_ustauct_6001() 


public 
UPAOFERTY( ei t Anyweers, BluepriatReadirite, Category 
mo | 

Vetere Texture; 

UPAOPEATY( EditAnywbere, BluepriatReadirite, Category 
mio 

FLinearcel or Color 

i 


3. UseCol oredTexture. basa UPROPERTYI) in some Blueprintable UCLASS! ) 
usinga UPROPERTY( | declaration like this 


PROPERTY EditAnywhere, BiueprintReadiite, Category = HUD 
Feal oredTerturet Textare; 


The UPROFERTY|) specipedfortheF Col or edText ar e willshow up in the editor as editable 
ds when included as PROPERTY, | belds inside another dass, as shown in step 3. 


There's more 


The main reason for making a struct a USTRUCT | instead of just a plain old C+ struct is 
to interface with the UES Engine functionality. You can use plain C+ code (wthout creating 
USTHUCT( | objects) far quick smal structures that dont ask the engine to use them directly. 





Creating Casses 








Creating a UENUM( 


Ceterum are veryuselul in typical C++- code. UEA has a custom type of enumeration called 


ENUM, which allows you to create an enum that mil show up in à dropdown menu inside a 
Blueprint that you are editing 


How to do it. 


1. Gototheheader e that vill usetheUENUNI | you are specifying or create a 


HeEnumka ne. 
2. Use code ofthe form: 
t 
Stopped UNETA(DIsplayhame = stopped 
Moving QeTkLD spl ayame = = Movi ng") 


i 





3. Use your VENUNI ) ina UCLASSI I as folos: 


UPROPERTY| Edi Anywhere, BlueprintReadikite, Category 
Tënumtsðytecstatus> statusi 


UUENUM | show up nicelyin the code editor as drop-down menus in the Blueprints edio rom 
which you can oniy select one of a few values. 











a UFUNCTION 


UFUNCTI ON) are useful because they are C++ functions that can be called from both 
your C++ cent code as well as Blueprints diagrams, Any C++ function can be marked 
asa UFUNCTI ON) 





tini 








Chapter 2 





How to do it. 


1 





Construct aC! ass with a member function that you'd Ike to expose to Blueprints. 
Decorate that member function with UFUNCTI ON| 3I uepr i nt Cal 1 abl e. 
CategarysSemsCat egoy] lo make i callable from Blueprints. For example, the 
followings the Wr ar cass again: 
Clase RAPI Altar ar © publie Mete 
f 
cenenaten aont) 
PROPERTY eet tanya 
Hitring ame 
FUNCTION! aegri nta ae, Category = Froperti e 
string Taser ag] 











Create an instance of your ar ri ar class by dragging an instance on ta your 
game wor 


From Blueprints, call the T9Str i agl ) function on that Warr or instance by liking 
fan your Warr | or instance. Then, in a Blueprints diagram, tpe n etri ng). 
‘haul ook ike in thefllowing screenshot 








Creating Gasses 





In order to cata funcion an an instance, the instance must be selected in 
the World Outline when you start ta type into the autocomplete menu in the 
Blueprints diagram, as shawn in the folowing screenshot: 





UFUNCTI 04 | are really C++ functions, but with additional metadata that make them 
accessible to Blueprints. 





Memory Management 
and Smart Pointers 


In this chapter, we are going to cover the following topics: 


Unmanaged memory- using mal! oct 
Unmanaged memory- using nende! 
Managed memory- using Newb ect € > and Construct Obj ect < > 
Managed memory- deallacating memory 
Managed memory- smart pointers TSharedPt r 
an object 

UsingTScopedPsi nter to track an object 
Unreals garbage collection system and UPROPERTY | 
Forcing garbage collection 

Breakpoints and stepping through code 

Finding bugs and using call stacks 

Using the Prcorto identify hat spots 








aite Thut oft to track 





Memory Management and Smart Painters 


Intro ion 


Memory management is always one of the most important things to get rightin your computer 
program to ensure stabilty and good, bugfree operation of your code. A danging pointer 
[pointer refering to something that has been removed from memory) is an example of a bug 
tatis hard to track Iit occurs. 


"iml" a lm 


Ups ect derivatives: This is the default way at your memory wil be managed within your 
UEA program. 














M you write custom C++ classes of your own, which do nat derive fom Lob] ect you may 
Inilthe'Snarea?tr / Teak Ptr reference counted classes useful These classes provide 
feference counting and automatic deletion for O reference objects. 








This chapter provides recipes for memory management within UE 





d memory - using m free( ) 
The basic way to alocate memory rou computer program in C (and C+) by using 

mat Toc) east ec]) designates a block of te computer stems memory fo our 
rogams use. Once your program is using a segment of memory no other program can use 
ar access that segment of memary An attempt ta access a segment of memory rot alocated 
{2 your program wil generate a "segmentation faut and represents an Wega operation on 
mast tens. 


How to do it... 


Lets look at an example code that allocates a pointer variable 1 , then assigns memory to it 
sings! ac | |. We allocate a single integer behind ani nt * pointer. fter allocation, we 
store a value inside’ nt, using the dereferencing operator * 





im* is JU Declare a pain 














Capt 
|= | date ymatvect sizeof int 1}: HE Allacates system memery 

Hie as E Ausign the value 0 iato variable 

PURI UE contains N", ^] i 1) Use the variable i. ensuring te 

Ji oxe deraterencing operator * during use 

11 RELEASING MEMORY OCCUPIED BY | TO THE SYSTEM 

fees] i |; 1) Wen we're done using |, we free the menory 

Jf allacates far it back to the system 

| AE Set the pointers reference to address ¢ 


The preceding code does what is show in the diagram that folos: 








1, Tebstine crentes ani nt» pointer variable i which starts as a dangling pointer 
refering toa segment of memory that probably won be valid for your program to 
reference, 

2. Inthe second diagram, we use a mal 1 oc ) call to inttialize the variable to point 
Toa segment of memory precisely the sizeof ani nt variable, which wil be valid lor 
yur program to refer to. 

3. We then intialize the contents of that memory segment to the value using the 
command") = 0 





wae (ln oe sea int) N 














Note the diference between assignment to a pointer variable ( 
"Thich tele te pointer wnat mermary address to refert, and 
assignment to whats inside the merar address that the pointer 
Varableretes tot el 





zr 
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Wen the memoryin the variable! needs to be released back to the system, we do so using 
afre | dealicaton call as shown in the following diagram. | is then assigned to point to 
‘memory address, (lagrammed by the electrical grounding symbol reference $). 


ar ti 














The reason we set the variable to point to the NUL L reference is to make t clear thatthe 
variable does not refer to a valid segment of memory 


Unmana 





d memory 





The new operator is almost the same as a mal} oc call, except thatit invokes a constructor 
‘alion the object created immediately after the memory s allocated. Objects allocated with 
the operator new should be dealocated withthe aperatordel ete and ot! reel) ) 


Getting ready 


In Cat, use of ral oc(| was replaced, as best practice, byuse of the operator new. The 
main difference between the functional of m oci) and the operator new ie Ihat n: 
cal the constructor on object types after memory allocation. 











mI Te 
"oraesa neg USUS space ruse] AlocsesaunegfConiqunus space ur 


Cals constructor as object type used as 
an argument i the operator 














Inthe flowing code, we declare a simple 0b] ect cass, then construct an instance afit 
using the operator: 


puts} object constructed? | 








aptera 





] 
abject) 
t 
putsi “Object destracted" ) 
, 
n 
Object” abjecte new object(ys D Lavakes 
EM J1 resets abject toa mull painter 


The operator new works by allocating space justas ma! | 2c() does. I the type used with the 
operator new is an object e, tne constructor is invoked automatically withthe use ofthe 
keyword new, whereas the constructor is never invoked with the use of mal oc £} 


There's more. 


You should avoid using naked heap allocations with the keyword new (or ml 1 oc for that 
mater). Managed memory is preferred within the engine so that all memory use i tacked 
and clean. if you allocate à Uo] ect derivative youdebnity nood to use eos ect < > or 
Vonstroctüs] ect « > [outined in subsequent recipes). 




















Managed memory refers to memory thats allocated and deallocated by some programmed 
subsystem above the nev, fel te, mall ae, and r ee calls in CH These subsystems are 
Commonly created so that the programmer does not forget to release memory after allocating 
It Unreleased, occupied, but unused memory chunks are called memory leaks. For sample: 


ob enm ie 
mew int] Sta]; 1) generates memory Lenis galore! 





Inthe preceding example, the memory allocated is not referenceable by any variable! So you 
an neither use the allocated memory after the or loop, nor can you free E If your rogram 
allocates all available system memory, then what wil appen is that your system wil run out 
of memory entirely and your O5 wil yag your progam and dase it for using up too much. 
memory. 





Memory Management and Smart Painters 


Memory management prevents forgetting to release memory In memarymanaged programs, 
ils commonly remembered by objects that are dynamically located the number of pointers 
referencing the object When there are zero painters referencing the object, itis either 
automaticaly deleted immediately or aged for deletion on the not run of the garbage 
collector, 


Use of managed memoryis automatic within UEA. Any allocation of an object to be 
used within the engine must be done using Kew ect < >(} orSpawnAct or< >l) 
The release of objects is done by removing the reference to the abject, then occasionally 
calling the garbage cleanup routine (isted further in this chapter). 


Getting ready 


When you need to construct any Oh ect derivative that is not a derivative of the Act or 
class, you should always use Vew0o| ect « >.SpawnActer« > should be used ony when 
the object is an Act or oris derivative. 


How to do it. 


‘Say we are tying to construct an abject of type ct ion, which itself derives from Ud ect 
For example, the following class: 


MLASS( BI vepri nt Type, Blueprintable, met 
klass far any Atlee type") | 
Chass BY API action € public Wob ect 





bore Tooltips Base 


GEVERATED_UCLASS, sooni 
patie 

PROPERTY Edi ny mere, 8L veprinthesdirite, Categorysh 
Fotriag Text 

UPROPERTY| Edi Jay mere, Bi vepeintRezdWeite, Categer yh 
Fey Shortcut ey 


j 
To construct an instance of the Vct ion class, we'd do the following: 





spertiesi 








setis 


Mietier* action = MewDb]ectelieti ens) Gerlraeri ert Packagel). 
Mactien: stati ctlass]) 1) Mt flags n] 


Hee Action: : Stati cCI ass(] gets you abase UCI ass" forthe UActi on abject The 
Ipstargurentto ej ect < > Get Transi ent Package) hich simply revives the 
"ransent package for the game. A package (UP ackage) in UES is justa data conglomerate. 
Here we use the Transient Package to store our heapalocated data. You could also use 
UPROPERTY( | TSubel ass chAct or> from Blueprints to selecta UCI sss instance 
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aptera 


The third argument (optional) is a combination of parameters that indicate how UObj ect is 
teated bythe memory management system. 


There's more 


There is another function very similar to NewOh ect < > calledConstr uct Obj ect < ». 
Const rect Ob] ect « > proudes more parameters in construction, and you may pnd it useful 
if you need to specify these parameters. Otherwise, e vos] ect works just pre. 


See also 


= You may also wantto see the documentation forAF_* fags atht tps: i] decr 
Unreal engi se, com et est] NT) Programmi vi Unreal Archi tecture) 
Obj ecte/ crests anl inde, At mi rob] eet Tags 





locating memory 





obj ec s are reference-counted and garbage-collected when there are no mare references 
tothe Udb ect instance. Memory allocated on a UObj ect class derivative using 
Construct Db ect e» ortewDsj ect « > can also be deallocated manually (before the 
reference count drops to O) by caing the Ub, ect: Conditional Begi nDestreyi 
member function. 


Getting ready 


‘You'd only do this if you were sure you no longer wanted UOb ect ortheUObj ect class 
ervatie instance in memory Use the Condit ora! BeqinDestrey|) funcion to release 
memory. 


How to do it... 


The folowing code demonstrates the deallocation ofa Lob ect cass: 





object te = Nendbjecte Uobject >}... ) 
f->Cendi ti onal Bag est rey 


How it works... 


‘The command Condi ti onal Begi nDest roy) begins the deallocatio process, caling the 
BesisDestreyl) andFinishdestray( | overideable functions. 
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There's more. 


Be careful not to call Ohi ect Condi t eral Begi nDestray(| on anyablec stil being 
referenced in memory by other objects painters. 


Managed memory - smart pointers 
(TSharedPtr, TWeakPtr, TAutoPtr) to track 


an object 





When people are afraid that hey forget the del et» call for standard C++ objects they 
create; they often use smart pointers to prevent memory leaks. TShar e£? r i a very useful 
Cet clas that wll make any custom C++ object reference counted. ith the exception of 
Ups] ect derivatives, hich are alreadyreferencecounted An alternate class Teak Pt r is 
also provided for pointing to a reference-counted abject wth the strange property of being 
Unable to prevent deletion (hence, ea 

















dDp Uhjeet andis cere casses laryting eatea wth 
Q omi 


Construct Ob ect cannot weT Shar eéPt r t 
Getting ready 


? you dont want to use raw painters and manually rack deletes into your C- code that does 
not use Obj et darivatives, then that code is a good candidate for using smart pointers 
suchas TShar eePrr TSharedket , and the like. When you use a dynamically allocated 
abject (created using the keyword ne), you can wrap it up na reference counted pointer so 
that deallcation happens automatically The diferent types of smart pointers determine the 
smart pointer behavior and deletion call me. They are as falows: 





= TShar edPt r :Athreadsafe (provided you supplied ESPNode: : Threads e as 

second argument to the template reference-counted pointer type that Indicates 
a shared object The shared object will be deallocated when there are no more 
references to it 


+ Taut aPt r iNonthreadsafe shared pointer. 











How to do it. 


We can demonstrate use of the four types of smart pointers referred to previously using a 
short code segment. in all ofthis code, the starting pointer can either be a raw pointer, or a 
“Copy of another smart pointer. All you have to do s take the Ce raw pointer and wrapit ina 
constructor calltoany of Shar edPt r TShareshe ,TealPtr, orTAut Ofte 


For example: 


J1 C44 Class NOT derivi ag from Yoh ect 
lass Mytiass () 
Teharedrtr anti assosharedPte] new MyClass) | 


‘There are some differences between weak pointers and shared pointers. Weak pointers do 
nat have the capability to keep the object in memory when the reference count drops to 0. 








The advantage of using a weak pointer (over a raw pointer) is that when the abject undemeath 
the weak pointer is manually deleted (using Condi ti ona! Begi nDest rey] the weak 
pointers reference becomes a NULL reference. This enables you to check If the resource 
Underneath the pointer is stil allocated property by checking a statement of the form: 


i gt latii] ) JI check to see Lt the pointer is valid 
1 
} 


There's more, 


‘Share pointers are thread-safe. This means that the underlying object can safely be 
manipulated on separate threads. Aways remember that you cannot use Tha edet 

vith JObj ect sor UOb ect dertathes-onlyon your custom C++ classes, or on your 
Structures can you useanyoftheTSharedPtr,TSharedRet Teak Ptr classes to 
wrap up araw pointer. You must use Tes kQs) ect Poi nter arUPROPERTY|) asa starting 
point to point to an object using a smart pointer, 


You can use Thut Ptr ifyou do not need the thread safety guarantee ofTShar edPtr 
Taut aPtr wil automatically delete an abject when the number of references to it drops to 0. 


ng TScopedP rack an ob 





[scoped pointer is a pointer that is auto deleted at the end of he block in which it was 
decred. Recall that a scope is just a section of code during which a variable is "alie", 
Ascope váli last urti te prst dosing brace, that occurs. 





Memory Management and Smart Pointers 
Fer example, in the following bec, we have two scapes. The outer scope declares an integer 


variable x (valid for the entre outer block), hile the inner scope declares an integer variable 
y Wald for the inner block, after the ne on which tis declared 


' 
( 
| JE stope of y ends 


Getting ready 


‘Scope pointers are useful when itis important that a reference-counted object (which sin 
danger of going out of scope) is retained for the duration of usage. 


How to doit... 


To declare a scoped pointer, we simply use the folowing syntax: 





TscapedPoi nter eare i or» warti orl this 


‘This declares a scoped pointer referencing an object of the type declared within the angle 
brackets: € Allarri er > 


‘TheTScoped?o’ nter variable type automatically adds a reference count to the variable 
pointed to. This prevents deallacation of the underlying object for at least the le of the 
scoped pointer, 





UPROPERTY() 





When you have an object (suchas Thr rye >)as aUPROPERTY|) member of UCLASS| 
ou need todecare that member as UPROPERTY ) (even if you wont edi itn blueprints) 
otherwise TAr r ay wil not stay allocated property 








aptera 


Saywe have a UCLAS 





acus 
last NYPROJECT_API Alarrior : geblic eter 
1 

|Tieraye Fsoundettect > Greats: |] Incorres 
ÜHOHERTHI Tarraye FSoungetfeet > Greets; JI Corre 
D 


You'd have to the TArr2y memberas UPROPERTY( | for itto be propery reference 
counted. I you dont do so, youl get an unexpected memory error type bug sitting about in 
the code. 


‘he UPROPERTY| ) declaration tells UEA thaLTAr ay must be propery memory managed. 
Wihoutthe UPROPERTY( | declaration, your TAr ray wont work properly. 


Forcing garbage collection 


When memory bis up, and you vant to free sorme of it, garbage collection can be forced. You 
seldom need to do this, but you can do itin the case o having a very large texture for set of 
‘textures that are reference counted that you need to clear, 


Getting ready 


Simplycall Condi ti onal Begi nDestray[) on alloh ect s that you want deallocated from 
memory, or set their reference counts to 0. 


How to do it... 


Garbage collection is performed by calling the following: 





Getmori dl )->For cear bageCol Lectiont true | 





Breakpoint: 


Breakpaints are how you pause your C+ program to temporarily stop the code from running. 
and havea chance to analyze and inspect eur programs operation. You can peer at variables, 
Step through code, and change variable values. 





i 
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Getting ready 


‘Breakpoints are easy to set in Visual Studio, AN you have to do is press F9 on the line at code 
‘that you want operation fo pause at, or ick In the rey mari to the left of the ine of code. 
that you want to pause operation at The code wil pause when operation reaches the ne 
indicated. 


How to do it... 


1. Press F onthe ine you want execution to pause at This will add a breakpoint to the 
code, indicated bya red dot, as shawn in the screenshot below: Clicking on the red 
Sot toggles it 





| BH a 99 R, 








2. Set Bld Conpguration to any ofthe conbgurations with Debug in the title 
DebugGame Eater or simply DebugGame you wil launch without the editor, 


3. Launch our code by pressing F5 (without holding C) or select the Debug | Start 
Debugging menu option. 


4. When the code reaches the red dot, the code's execution wil pause. 


5. The paused vew wil take you to the code dir in Debug mode. In this mode, the 
windows may appear rearranged, with Solution Explorer possibly moved to the 
‘ight, and new windows appearing at the bottom, including Locals, Watch 1, and 
Call Stack. f these windows do not appear, pr them under the Debug | Windows 
Submenu. 

6. Check out your variables under the Locals window (Debug | Windows | Locals) 

7. Press FID to step overa ine of code. 


3. Press F1 to step into a line of code. 





it work: 





Debuggers are powerful tools that allow yu to see everything about your code as k is running, 
including variable states. 
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‘Stepping over a line of code (F10) executes the line of code in its entirety, and then pauses 


the program again, immediately at the nox ine. I the line of code is a function call, then the 
function is eec.ted without pausing atthe bs ina of code of the function call For example 


virt 
1 

11 FLL pauses here 

UE LOG Lagtemp, Warning, TEXTI "Leg message | 
) 
[ 

fi 1) Breakpoint here: FIO rans and ships to next Iiae 








When you have a bug in your code, Visual Studio halts and allos you to inspect the code. The 
place at which Visual Studio hats nont always be the exact location of the bug, but it can be 
ase. il atleast be ata line of code that doesnt execute properly 


Getting ready 


In this recipe, wel describe Call Stack, and how to trace where you think an error may come 
from. Tryadding a bug to your code, or add a breakpoint somewhere interesting hat you'd Ike 
to pause for inspecto. 


How to do it... 


1. Run the code to a point where a bug occurs by pressing F5, or selecting the Debug | 
Start Debugging menu option. For example add these lines of code: 





Uobject *a = 0; /) Initialize to am Illegal nuli painter 
soe Kamel]; JI Try and get the nane of the object (has 


‘The code wil pause at the second ine (Get Name). 


When the code pauses, navigate to the Call Stack window (Debug | Windows | Call 
Stack). 





Memory Management and Smart Painters 


The Call Stack is a tf function calls that were executed. When a bug occurs, the line on 
wich it occurred fisted at the top of the Call Stack. 
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he Pr 


The C+ Proper is estrerrely useful for piding sections of code that rece a high amount 
of processing tire, Using the Prolr can heip you rd sections of code to focus on during 
‘oplrization. If you suspect that a regan of code uns samiy then you can actalycorerm. 
thatitisnt slowif it doesnt appear highlighted in the Probier. 


How to do it... 


1. Goto Debug | Start Diagnostic Tols Without Debugging. 





ler to iden 





Using fy ho 








EP e 


ag 0 


















2. Inthe dialog shown in the preceding screenshot, select the type of analysis you'd Ike. 
splayed. You can choose to analyze CPU Usage, GPU Usage, Memory Usage, or 
Stop through a Performance Wizard to assist you în selecting what you want to see: 
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3. Click on the Start button at the bottom af the dialog. 
4. Stop the code ater a brief time (less than a minute or two) to halt sample collection. 


Do notcollecttoo many samples or the Profle wil take 

a really long tme to start up. 

5, Inspect the results that appear in the. di ags si on He, Be sureto brose 
all available tabs that apen up. Avalabl tabs wil vary depending on the ype of 
analysis performed, 


How it works. 





“The C+ Probe samples and analyzes the running code and presents to you a series of 
‘dag and pares about how the code performed. 





Actors and Components 


In this chapter, we wl cover following recipes- 
= Creatinga custom Act or in C++ 
^o Instantiatingan actor using Spawndct or 
= Destoyingan Actor usingDestr oy and a Timer 
*— Destoyingan Actor after a delay using Set Li teSpan 
= Implementing the Act or functionality by composition 
= Loading assets into components using Obj ect Fi nder 
Implementing the Act or functionality by inheritance 
= Attaching components to create a hierarchy 
= Creatinga custom act er Component 
= Creatinga custom scene Component 
= Creatinga custom Pr si ti ve Component 
= Creatingan inventor yConponent foran RPG 
= Creatingan Or bi ti ngNovement Component 
= Creatinga building that spawns units 


Introduction 


Actors are classes which have some presence in the game world. Actors gain thelr specialized 
functionality by incorporating Components. This chapter deals with creating custom Actors 
and Components, the purpose that they serve, and how they work together. 
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Cr 





ting a custom A in C++ 





While there are a number of different types of Actors that ship with Unreal as part of the 
‘faut installation, you wil prel yourself needing to create custom Actors at some point during 
your projects development: This might happen when you need to add functionally to an 
‘ting cias, combine Components in a combination not present in the default subclasses, 
‘rads addtional member variables to a class The neat tmo recipes demonstrate how to use 
tether composition or Inheritance to customize Actors 


Getting ready 


Make sure you have installed Visual Studio and Unreal as per the recipe in Chapter 1, UEA 
Development Taole. aut alo need to have ether an existing project, of create a new one 
using the Unreal provided wizard. 


How to do it... 


1. Open up your project within the Unreal Editar, then click on the Add New button in 
Content Browser 





2. Select New C++ Cass. 
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3. Inthe dialog that opens, select Actor from the it 


Choose Parent Class 
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4. Give your Actor a name, such as yF r st ctor, then diek on OK to launch Visual 
Studio. 


Vihen using this dass creaton wizard, make sure you don't prefa pur 
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Name Your New Actor 








5. When Visual Studio loads, you should see something very similar to the folowing 
pos 
Mihirstactor 
pragma once 
acl ade “Ganetramever ti Actor 
nel ade “WyFiretactar. generated h 
ucussi 


Class MEACEDUEDDL AI. AMpPirstActar : public Acto 
t 


cenenaten BODY] 








anyfiestactert) 
i 
Mytirstactar. cop 
acl ade "UEACookBook. h" 
tinci ude “WEL estactar e 
AW estactor: sANyFirstactor() 
t 
Pri mat yActorTi ct. beangverTi ct = true: 
1 


Intime, yout become familar enough with the standard code, so you wil be able to just 
reat new clases rom Visual Studio without using the Unreal wizard. 


‘pragma once: The preprocessor statement, or pr agma, is Unreal expected 
method f implementing include guards peces of code that prevent ani acl ude He 
"om causing errs by being referenced multiple times. 

#incl ude "GameFramewor k) Act or. h" : Were goingto create anactor 
Subclass, so naturally we need to include the header Helorthe cass we are 
inheriting trom. 

include "WyFirstActor. generated. h"  Allactor classes need to include 
Deirgener ated. h He. This Hess automatically created by Unreal Header Tool 
(UAT) based on the macros that it detects in your Hes. 

UUCLASS{ ):UCLASS is one such macro, which allows us to indicate thata class wil 


be exposed to Urrea rejection system Rejection allows us to inspect and iterate 
object properties during runtime as well as manage references to our objects for 
garbage collection. 

class UESCOOKBOOK API AWyFirstActor : public Ahctor:This isthe 
actual declaration of ur class. The UEACODKBOOK_API macro is created by UHT, 
and is necessary to help our project compile property on Windows by ensuring 

that our project module's classes are exported correct in the DLL. You wil also 
notice that both wy ret ctor and Act or have the preach the the naming 
convention that Unreal requires for native classes that are inherited rom ctor 
GENERATED, BODY ) :GENERATED, BODY is another UHT macro thathas been 
expanded toincude the automatically generated functions that the undying UE 
type system requires. 

Pri maryActerTi ck. CangverTi ck = true: :Inside the constructor 
implementation, this ine enables ticking for this At oA Actors have a function 
called: ck, and this Boolean variable means that the Act or wil have that function 
Called once per frame enabling the actor to perform actions in every frame as 
necessary, As a performance optimization, this is disabled by defaut. 





m 
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an Actor using SpawnActor 





Fer this recipe, youl nee to have an Act ar subelass ready to instantiate. You can use a 
butin class such as Stat eMestAct orbit would hei à practice wih the custom 
deter you made in the previous recipe. 


How to do it. 


1. Create a new C++ class, ike in the previous recipe. This time, select Ga me Node as 
your base class, gwing ita name such as UE 4 Cont boot Game Mode. 





2. Declare a function override in your new Game Node class: 
virtual vold BegiaPlayl) override: 


3. Implement esi nP! ay inthe. cop He 





t 

Super: : tegi etra] 
engl ne-shagOnScreesDebughessege( 1, -1, Fosters Ned 
TESTI Actor Spawn") 





KbookűameMede: deni nta) 








Hans 
Set tori a| )->Spanndc 





AME rst eter 
tassi). ssencecatierl 





4. Compile your code, either through Visual Studio or by clicking on the Compile button 
in Unreal Editar. 
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Open the World Settings panel for the current level by clicking on the Settings 
toolbar icon, then pick World Settings fram the dropdown menu. In the GameMode 
Override section, change the game mode to the Ga meN de subclass you just created 
aS shown in the follwing two screenshots: 
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‘Start the level, and very that Ga ne ote spawns a copy of your àc t er in the world 
bylooking atthe World Outiiner panel. You can verify that the eg! s a) function is 
being run by viewing the Actor Spawning text being displayed on screen. t doesn't 
pa, make sure there are na obstruction at the ward arg to prevent the Act or 
fem being spawned. You can search the ist of abject in the word by typing in the 

search barat the top of the World Outiner panel to ter the erties shonn. 





1 








Ganelags is a spacial type of actor which is part of the Unreal Game Framework: 
"our map's Gamea de is instantiated by the engine automatically when the game 
stars 


By placing some code inta the Begi nPI ay method of our custom Gamelioge, we can 
run it automatically when the game begins. 

Inside 8e9ixP1 ay, we create an Transtar mto be used bythe Spawnāct o 
function. Bydefault T^ anst arm i constructed o have zero rotation and a location 
atthe origin. 

We then get a reference to the current ves Ur! d instance using Get or | d, 
then callitsSpanAct er function. We passin FTr ansor m, which we created 
arie to specify that the object should be created at ts location, that is, the rin. 

















‘This recipe wil reuse the Ga me Ne de fromthe previous recipe, so you should complete rst. 


How to doit... 


1 


Make the following changes to the Ga se oe declaration: 
Jar estActor® Spamedscter 
Urune ont 


Add #incl ude "Fi rst Actor. A tothe irplementation He's includes. 
Assign the results of SpaunAct or tothe newSpaunedAct or variable 


Speenedict or = GetWori a[)->Spawnact or <AMYFi rit etur 
CAME rette Stati ctas), SpawnLocati on 








‘the following to the end af theBegi s! ay function: 


Getar dTi mer anager. SetTi mer |i mer, this 











Lastly implement Dest rayAct or Funct i on: 





( 
Lf [Spamneaactar t= nuliptr) 
[ 





i 


Load the level you created in the previous recipe, which had the game mode setto 
your custom class. 


Play your level, and use the Outiner to verf at ours swnedAct or gets deleted 
ater 10 seconds. 
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= We declare a UPROPERTY to store our spanned Actor instance, and a custom 
function to call so that we can cali Dest roy(} on a timer: 
Anti rstactor* Spanedi 
UuFUncT! on 








^o Inegi ePi ay, we assign the spanned Act or to our nem UPROPERTY 


Spannedict or = Get Wor! dL) Spector AP ret etur 
ei rataetar: Stati ctlaegi. Spennvacztl on 





= We then declare aTi mer Handi e object, and pass itto 
Get erl dTi mer Manager: Sel Timer -Set Ti mer calls Destroykcter Function 
on the object pointed to by this painter after 10 seconds. Set Ti mer retums an 
"abjecta andle-in allow us to cancel the mer f necessary. The Set 7i zer function 
takes the Ti mer Handi e object in as à reference parameter, hence, we declare itin 
advance so that we can pass it into the function property 
Geter I dTi mer Managert). SetTi mer [Ti mer, this 
GAUEUCookDsokGameoge:DestreyActorFunet! on, 19) 





^ Theest royAct or Fu 





i an checks if we have a valid reference toa spawned 








val AUEACookbookGameMode: : Dest royActor functi os| 
( 
If Espameditor t= mult pte) 





$ 


= Mme do, it calls Dest roy on the instance, so it wil be destroyed, and eventually. 
garbage collected: 


Spawnedäctor->bestroyl | 





De: 





oying an Actor after a d 
tLifeSpan 


Lets look at how we can destroy an Act or 


ay u: 











How to doit... 


1 
2 


Create a new C++ class using the wizard. Select Act or as your base cass. 
Inthe implementation af Act or, add the following code to the Begi aP! ay function: 
senti esp tol 

Draga copy af your custom Act or into the viewport within the Editor. 


Play your level, and look atthe Outiiner to very that your Act or instance disappears 
after 10 seconds, having destroyed itself. 





1 





We insert our code into the Begi nPI ay function so thatit ewcutes when the 
game starts. 


Set Li feSpant 10]; The Set Li fe5pan function alons us to specify a duration in 
Seconds, alter which the et or calis s own Dest r oyt) method 


the Actor functionality by 





composition 


Custom Actors without components don't have a location, and cant be attached to other 
Actors Without a root Component, an Actor doesnt have a base transform, and so it has no 
locaton. Most Actors, therefore, require at least one Component to be useful. 


We can create custom Actors through composition—adding a number af components to our 
Actors where each component provides sme o the functonaliy required 


Getting ready 


This recipe wil use the Actor class created in the Creating a custom Actor in C+ recipe. 


How to do it... 


1 





Ad a nen member to your custom dass in Ces by making the 
the publi section: 

m 

stati cMeshComporent Mesi 


owing changes in 


Aad the following line to the constructor inside the cpp Be 
(Creat ebef aul tSubabj ect t ati eMeshComponent >(* BaseMeshConp 
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3. Very your code looks like the following snippet, and comple itbyusing the Compile 
button in the editor, or buiding the project in Visual Studio: 
ucassi) 
class UEACOOKBOOK_APL AMyFirstActar © pi 
$ 


blie aeter 





ceneraTen eony) 
public 
ANyFirstactert) 


uraareary() 
stati cieshorponent* Mesh; 
I 


mE 
tinci ude “Wl estactar e 
Ape stactor: ANH rs actor) 
í 
Pri meryActorti ck. Gebiet = true: 


Mesh = CreateDetaul Subst) ect cuseatichsnComensst> 
taseueshConparent™) 
Jj 


4. Once youve compiled this code, drag an instance of our cass fom the Content 
Browser out into the game environment, and you wil be able to verly that now. 
has a transform and other properties, such as a Static Mesh, which comes from the 
Stati cMeshConponent that we added 


1. TheUPROPERTY macro we added to the class declaration is a pointer to hold the 
component we are using as a subobject af our Act or 
nm 
Ustat cMeshComponent Mesh 


2. Using the PROPERTY | macro ensures that the object declared in the pointer is 
considered to be referenced, and wont be grbage collected (that is, deleted) out 
fram under us, leaving the pointer danging 
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3. Were using a State Mesh component, but anyof the Act or Component subclasses 
would work. Note the asterisk is connected to the variable type in accordance with 
Epic's stye guide. 

4 Inthe constructor, we initialize the pointer to a known valid value by usinga 
tempi ate function tempi ateeclass Tietornlype» Thetornlype" 
CreateDetaul tSubobject(FName SubohjectName, bool bTransient = 
fle 








5. This function is responsible fr calling the engine code to appropriately initialize the 
component, and retur a pointer to the newly constructed object so that we can 
ue our component pointer a default value. This is important. obvious, to ensure 
that the pointer has a valid value at all imes, minimizing the risk of dereferencing 
uninitialized memory. 

6, The function is templated based on the type of object to create, but also takes 
vo parametersfithe rst one isthe narre of the stbobject which ideally shouid 
be humaneadabl, and the second is whether the abject should be transient 
(that is-not saved along with the parent object} 


See also 


The following recipe shows you how to reference a mesh asset in your Static Mesh 
Component so that it can be displayed without requiring a user to specifya mesh in 
etdior 


Loadin et: 
FObjectFinder 


Inthe ast recipe, we created a Static Mesh Component, but we didn't try to load a mesh for 
the Component t display. While irs possible to do this in the Editor, sometimes tis helpful to 
specify a defaultin Ce 


Getting ready 


Folio the previous recipe so you have a custom Act or subclass with a Statie Mesh 
Component ready. 


into components usin 
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In your Content Browser, cick on the View Options button, and select Show Engine Content: 





Browse to Engine Content, then BaslcShapes to see the Cube we wil be using n this recipe. 





How to do it. 


1 


‘Ad the folowing code to the constructor of your class: 
Constructor hel parsi: Fb] ectF| nder estat) cNeah>/ TEXTI stati 
Mery Eng ref Basi eSnapes/ Cupe Cube 1) 
TP {Weshisset Object t= nal pte] 

Mesa. agat Stati cMesh| WeshAsset, 0b) ct) 
, 
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2. Compile, and verify in the Editor that an instance of our class now has a mesh as its 
Visual representation. 


m We create an instance of the Fobj ect Fi nder class, passing inthe ype of asset 
that we are tying to load as a template parameter, 

^ FObj ect Fi nder isa class template that helps us to load assets. When we construct 
it, we pas in a string that contains a path to the asset that we are trying to load 

= Thestringis ofthe format" [Db] ect Type] [atti Ta) Asset. Asset’ Note the 
se of single quotes in the string. 





^ In order to get the string for an asset that already ets inthe editar, ou can right 
cick on the asset in the Content Browser and select Copy Reference This gives you 
the string so you can paste tinto your code 





‘+ Weuse the aut a keyword, from C++21, to avoid typing out our whole object type in 
As declaration; the compiler deduces it for us. Without atc, we would have to use 
the folowing code stead: 

Constructar¥el pers: Fab] ect nder sustat clash Meshisset 
Canstructarhel pers: Fob] ect¥lager sustat | esi TERTI Stat 
Nash’ | Engi nej basi eShapes/ Cube. Cube" *)) 








= TheFOb| ect Fi nder class has a property called Object that wil elter havea 
Pointer to the desired asset, or wl! be NULL ifthe asset could nc be found. 


This means that we can check itagainst au! | ptr, and isnt nul, assign itto 
Mesh usingSet Stati cesh 





m- 


‘tors and Components ——————————————————À 


he Actor functionality by 





Inheritance i the second way to implementa custom Act or This commonly done to make 


anew subclass, which adds member variables, functions 
Act or class. In this recipe, we are going to add a variat 


à Component to an esting 
a custom GameSt ate subclass, 





How to do it... 


1 


2 


In the Unreal Eitor, click on Add New in the Content Browser, and then on New C++ 
Class.. then select GameState as the base class, then give your new class a name 
‘Ad the following code to the new cass header 

AnyGamest te) 


vai SetScorel int32 Newscere 


vrincriont 
int32 ets 
private 

ini currents 








Add the following code to the cpp He: 
JiyGamestate: :AMyGanestatel | 





kata2 AMyGameState:: Get Scorel) 


return Currentseore: 


Moid AMyGanestate:: Set Scorel int32 Meuscore) 
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‘Contrmthat your code looks Ike the following listing, and compile using the Compile 
button in the Unreal Editar 


Mrtamestat eh 
thragma once 


#i ncl ade *GameFranewor ki Ganestate.t* 
* ntl ide “Woanestate generated. hi 


P 
ücassl) 

Class UEACOOKBOOK_APL ANyGanestate : public AGanestate 
t 


sENERITED, soove) 
mic 
Ay Gare ate) 


uraareary() 
Intt currastseere 


arie on) 
inti Getscerell 


arwen on) 
alg SetScarel ui nta? Newscorel 

n 

Mrtamestat e cop 

Pinel sde “Ueteeokteok. ht 

Finci ade “Myanestate. h" 


Aycamest ates: amy Gamestat el 


Currentstore = d 
] 


jer MMyGamestate:s Get Scorel) 
t 
return Currentseore: 


Moid ANGaneSt ate: Set Score|ulet32 WeuScorel 


t 
Current scare = Wewscore: 


, 
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1. Firsty we add the declaration of a default constructor: 
AsyGamest ate) 


2. This allows us to set our new member variable to a safe default value of@ on object 
‘italian: 
AyGamest ates: AMyGamestat el | 
t 


current scare 
1 


3. Weusethei nt 32 type when declaring our new variable to ensure portabilty 
‘between the various compilers that Unreal Engine supports. This variable s going 
to be responsible for staring the curent game scare while itis running. As always, 
we wil be marking our variable with PROPERTY so hat itis garbage collected 
appropriately. This variabile is marked pri vat e so that the only way to change he. 
‘vale is through our functions: 

Pore) 
int32 current Scere 








4. The Get Score function wl reviee the current score, and retum ita the caller. t 
is implemented as a simple accessor, which simply retums the undering member 
Variable, 

5. The second function, Set Sc or e, sets the value of the member variable allowing 
external objects to request a change to the score. Placing this request as a function 
ensures that the Game Sta te can vet such requests, and anly allow them when 
valid to prevent cheating The specs of such a check are beyond the scope of this 
recipe, but these scere function i the appropriate place to make it 

6. Our score functions are declared using the UF UNCTI ON macro for a number of 
reasons. Firsty UF UNCTI ON, with some additional code, can be called or overridden 
by Blueprint. Secondly, UFUNCT! ON can be marked as exec -this means that they 
‘an be run as console commands bya player or developer during a play session, 
Which enables debugging. 


^ Chapter, Integrating C++ and the Unreal Editor, has a recipe, Creating new console 
commands, that you can refer to for more information regardinge xet and the 
console command functionality 
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Attachin 


ate a hi 





compon 





Vhen creating custom Actors from components, itis important to consider the concept ot 
Attaching. Attaching components together creates a relationship where transformations 
applied to the parent component wil also affect the components that are attached to It 


How to do it... 


1 
2 


Create a new class based an ctor using the editor and cali er archyAct ar 





‘Ad the following properties to your new cass: 
n 
Usceneconponest® Root 








stenstorpaneet* chil aSceseCenponest 
uporentt(| 

UStati cMeshComponent* Soxdne; 
UPROPEATHI I 

UStati cMeshComponent* SoxTas: 





‘Ad the following code to the class constructor: 
Rast = CreatedefaultSubobj ect ciSceseCompanent >| Rost") 
Chilascenetomponest = 

Createbetaul t$ubosj ect <UsceneComposent) CH | aSceneCansene 











Crest eter aul tSubobj ect Stati eaeshcomponent (bone) 
Bartus = 
Crentepet aul tuned) ect cust tl caeshcompanent [*BoxT a"). 


Canstructarhel pers: Ob ectFi nder <UStat i testo TENTI stati c 
Nes | Engine Sasi eShapes/ Cube Cube) 
IY (Mesasset. Obj ect t= nulipti 

t 

oxone- stet Stati cash Neshässet object 

BoxTwo.>Set Stati cash Neshasset. Ob] ect 

" 
aot component = Root 
Barone sat achat | 
Bartus- oat acevo chil aScesecen 
(Chil dSeeneConponest-sattachtar 
Chil dsceneConponest-osetiel at veTrans 
(Fregestermaotstorcd, 0. a), Fvezter(250, 0, 0) 
Facti ai 
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Verifythat your code looks like the flowing 


Hierarchyactor.h 
teragme ance 


#i ncl ade “Gameframenort Actora" 
include “Wl erarcnyact or. generated. ht 


uenas) 
Clase UEACOOKBOOK_API AMi erarchyāctor : public Meter 
t 

ceneraTen eoori 

public 

Mier archydctor{ 

virtual void Begin ay(] override 

Mirtusl volg Tiek loat Deltaiecends ) verri de 

urnareary() 

USceneConposent® Rest 

n 

USceneConponent® Chi dSceneComposent: 

mn 

Ustatl cieshconpanent® Bexone: 

upaagrear() 

Ustatl cieshconpanent® Bortun: 
y 
Hierarchyactor. cpe 


mE 
finci ade “Hierarceyaet or." 


AM erarchyActor::AM er archyActer() 
t 
Pri meryActorti ct. beangverTi ct = true: 
Root = Creat eDet aul tSubabj ect <USceneConpanent ("Root 
Chil dSceneCompasent = 
Createbetaul tSuseb] ect <USceneComsoneat> 
TG Hscenetonsenest*] 
Boone 
reat evet aul tSubobj ect stati cHeshcomponent >l 
p 
{reatevet aul rsuseh ect stati Nest Component» 
auta Meshasset 
Construtor Nel pers: Pob] ect Fi nder <UStati cest. 
[TEXTI Stati cas | Engl ae Bas l stapes) Cube. Cube! 1] 
1 (WesaAsset. Object t= nuliptr) 








oxone 








Ter 


























Compile and lunch the editor: Drag a copy of Herarchyctorinto the scene. 
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65. Veriiythatactor has components in a hierarchy, and that the second bochas a 
smaller size. 


* C 


Adi Component 





1. As usual, we create some PROPERTY tagged Components for our actor. We create 
‘two Scene Components, and two Statie Mesh components. 

2. Inthe constructor, we create default subabjects for each component. as usual, 

3. We then load the static mesh, and I loading is successful, assign tt the uo static 
mesh components so that theyhave a visual representation. 

4. We then construct a hierarchy within our Act or byattaching components. 

5. Veset the rst Scene Component as theAct or root, This component wil determine 
the transformations applied to all other components in the hierarchy. 

5. We theni attach the rst baxto our new roct component, and parent the second scene 
‘cerrpenentt te pret one. 

T. We attach the second boxto our chidi scene component so as to demonstrate how 
changing the transform on that scene component affects its children, but no other 
components in the object. 


3. Lastly, we set the relative transform of that scene component so thatit moves a 
certain distance away fram the origin, and sone tenth af the scale, 

9, This means that in the Eltor, you can see that the B1 Tee component has inherited 
the translation and scaling of its parent component, Chi | dscene Component 
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‘Actor components are an easy wayto implement commen functionality that shouldbe shared 
between Actors. Actor components arent rendered, but can stil perform actions such as 
subscribing to events, or communicating with other components f the Actor that they are 
present within. 


How to doit... 


1. Createan Actor Component named fandonMevement Component using the Editor 
wizard. Add the following dass specipers to the CLASS macro: 
UcLASSI lassGroupel Custam 
metasi b uept int SpawmabieConponent) | 





ng a custo 





‘or Comp 








2. Add the folowing UPROPERTY to the class header: 
prope 
fiat Noverent Radu 


3. Add the following to the constructor’ implementation: 
Novenenthadive = 


4. Lastly add this to the implementation off ckComponent  ) 











Axter* Parent = GetOmer{| 
it parenti 

( 

Favent-9setActorLocatl os! 
Farent-GetActorLacatl orl + 

Fiectar 

Path: Fhanéhangel-1, 1]? Wovemeat Radi us: 
Path Flanéfangel 1, 11° Wovement Radius, 
Path FRanaRangel-1, 1]? Movement Radi si} 


1 


5. Vertythat your code looks like he folowing: 
fteragm once 
#i nci ude “Components Actor Component b+ 
finci ede “Rangomovement Component. generate 
UCLASSI ci seeGravpst Cestami 
metasi b uep int Spawmabietonponent) | 
Clase UEACGOKBOOK_API URandomovementConponent : publie 








sENERATED, soov) 
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public 
VMasétmiovesent Component || 

virtual vald BegirPray(] override 

Yirtual vold TictComponent{ float Del ati ge, ELevel Tick 
Viektype, Factor ComsonestTictFunet iaa? TAISTI cktoretion | 
avertis, 

iraarear ic) 

float Movement hadi us: 
i 


mE 
finci ode “Randomovement Component, 2° 
Uhandomhovenent Component: : Ukandomovement Component 





( 
iüetstegi lay = true 
Feiner) Cenponent Ti ci hCanbvar Tit = true: 
Movement Aadi us = 3! 

i 


Vaid URandoaMovenent Component: egi nbl ay) 


Super: : begi Flay) 
i 


Vaid URandoniovensnt Component Ti ckConpenest( fles 
Deltarine, Euevel Tick TickType 
Factor conponeat i ckFuactl an ThisTickfunction | 
( 
Superi: Ti ckComponent| DeltaTive, Ticklype 
Tti eufuncti as) 
Metri Parent = Get Dene) 
IP (Parent) 
D 
Hirertoosethetertacat on! 
Parent. >GetAetorbacatl onl) + 
factu 
Pith FRandians 
Fuath. Flandhang 
Pith Handling 
D 


1 pt Movement had s 
Als Movement Rel as 
11^ Wevesert iati en] ) 





, 


6. Compile your project. In the editar, create an empty Act er, and add your Random 
Movement Component to t. To do this, drag an Empty Actor from the Placement 
tab out into the level then cic on Add Component in the Details panel, and select 
Random Movement. Do the same thing to add a Cube Component so that you have 
something to visualize your actor's position with, 
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T. Play your level, and observe the actor randomly moving around as its location 
changes everytime the Ti ckCanponent function is called. 
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1. Firstiy we add a few specbers tothe UCLASS macro used in our components 
declaration. Adding? uepr nt Spawsabl eComponent to the class' meta values 
means that instances of the component can be added to blueprint classes in the 
dior TheCI ass Gr oup spec allons us to indicate what category of class our 
Component belongs to in the list of casses: 

UcLISSI Cl assGraups( Custam 
metasi B uepri nt Spawnabi eto monent) | 


2. AddngMovement Radi us as a propertyto the new component allows us to specify 
how far the component mil be allowed to wander in a single frame: 
onere 
float Noverent Radu 

3. Inthe constructor, we initialize this property to a sae default value: 
NavementAadius =5 

4. TickComponent is a function thatis called every frame by the engine, just ike 
Ti ck is for Actors. In its implementation, we retrieve the current location of the 


components owner, at the Act or that contains our component and we 
(generate an offset in the word space: 











Meter Parent = GetOwneri | 
it parenti 
[ 
Farant-sSetActorLecatl os! 
Farent-GetActorLacatl asl + 
Peter] 
Path: Phanétangel-1, 1)* Wovemeat Radi us: 
Path: FRanaRangel-1, 11° Movenest hadi us. 
Fath: FRanaRange(-1, 11° Novenest adios] 


j 
} 


5. We add the random offset to the current location to determine a new location, and 
mave the owning actor to it. This causes the actors locaton to randomly change fom 
fame to frame and dance about 





Stene Components are a subclass of Act or Components that have a transform, hats, a 
relative location, rotation, and scale. Just ike Act or Components, Scene Components arent 
rendered themselves, but can use their transform for various things, such as spawning other 
(objets ata ped offset oman actar 


a 











How to do it. 


1 


Create a custom SceneCemponent called Actor Spaner Component . Make the 
following changes to the header: 

utuncri out 

vaid Spawel) 

noti 

Subcl sesQf <Adctor> aetorToSpamn 


Aad the following function imglementation to the cpp hle: 
veld UactorSpawnertomponent:: Spawnt | 


( 
imei thee ¢ 
Themen a! 








derent 
altel 





FTranstora CosponentTranstormithis 
Get Component Transtar m|} 
Ther id- >Spawnactor (Actor ToSpann, &Corponeet Transform). 
D 
' 
Verify your code against this snippet: 


ActorSpawser Component 
tragn once 


acl ude “Comonents/SceneComponent .h* 
acl ude “Actor Spammer Component. generated 





UcLASSI cl assGraupet Custom 
metasi bi uepr int Spawmabiečonponent) | 
Class UEACOOKBOOKLAPI UactorSpamnerComponent = public 
Usceneconponest 
t 

sENERATED, eoori 





pubiic: 
herr Spauner Component) 


virtual void MegiaPlay() override 


ietual vold TichComponent( float Deltafine, ELevel Tick 
Hiekiype, Factor ComsonestTictFunet ian? Tels eitoretien | 
verri ae, 
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UuFUMETION BI egent Cal able, Categery=Coctbast) 
vals Spam) 


UPROPEATY( Edit Anyahere) 
‘Suse! asst ekbcter> ActarTospamn: 


, 
ActorspanserCompovent. cop 
tinci ade “UEsCeokeeok. N" 
5i ttl ude “Actor Spamer Corgonen 





Actor Spanner Component: UActorSpauser Component || 


( 
itetsegi lay = true 
Pri mar yConpanent Tick. hCanbverTi ck = true: 


' 
veld UkctorSpanerComponeet:: Begi n?i (| 
( 

Super: : begi Flay) 
i 


taat 





veld UactarSpawnertomponent:: Ti ckConponent 
Deltarine, ELevelTick ThetType 
PheterConponest i ckFusctl ant Tai eTickFanctien | 
t 
Super: :TickCompanent | DeltaTi ne, Ticklype 
TT eufunctles T 


3 


veld Act rSpaanerConponests: S 





t 
Utarid" Theoria = Getari d) 
iren d Le nal pte] 
i 
Transform CosponentTranstormithis 
Det Component Transtar m }); 
Teetor d >Spanndct or(ActarToSpaan, Component Transform). 
D 
i 


4. Compile and open your project Drag an empty ar into the scene and add your 
Act or Spawner Conponent toit Select your nen Component in the Det ai | s panel, 
and assign a value to Act or Tospawn- Now whenever Spawn!) is called on an 
instance of your component, it will instantiate a copyof the Act or cass spaced in 
Actor ToSpamn. 
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We create the Spawn UFUNCTI ON anda variable called Act or Te Spawn. The 
Actor TaSpawn UPROPERTY is of ypeTsubcl ass0f < >,a template pe that 
allows us t restrict a pointer to either a base class or subclasses thereof. This also 
means that within the editor, we wil get a re tered ist af casses to pick from 
preventing us fram accidentally assigning an invalid value. 








inside the Span function's implementation, we get access to our world, andi check it 
tor validity 

Spawnctor wants an Transtar? to specify the location to spawn the new 
adir so we create a new stack variable to contain a copy of the current components 
Vanekom. 

Theo | di valid, we request ito spawn an instance of the Act or TaSpa v 
pected subclass passing n the address of theF Tr anst or m we just created, and 
lich now contains the desired location Tar the new actor. 





Actors and Components 


See also 


= Chapter 8, Integrating C++ and the Unreal Editor, contains a much more detailed 
investigation nto how you can make things Blueprint accessible 


stom Primi: 





Pri mi ti ve components are the most complex type of Act or Component because they not 
nly have a transform, but are also rendered on screen. 


How to doit... 


1. Create a custom C++ class based on er^ Component . When Visual Studio loads, 
ada thefoling to your cass header He: 
UcLASS| CI assGroupsEnperi mental, meta 
(Blueprint Spawnabl eComporent)) 
vai 
Virtual FPeimtivescenePrany® Cresteseenebrongl| override 
Tarrayeint2> Ind ees 
Tarraa Vector» Verti ces 
UHOPERTY Edi tAnywhere, BluepritRezdieite, Category = 
Unter al thevateria 











2. We need to create an implementation for our overridden Cr eat eSceneProxy 
function in cur epp Be: 
FPrimtiveScessProxy* Unyseshconpasent :CrestesceneProny() 
t 


FPri miti vesceneProxy Proxy = NULL 
Prony = new Fiscenebrasy this 





" 


3. This function retums an instance of Fy ScenePr oxy, which we need to implement 
Do so by adding the following code above tne Cr eat eScenePr oxy function: 
class PhySreneProxy : public Pri ti veStesebrony 
È 

public 

FaysceneFrexy(UyNeshComponest * Component | 
FPr im ti vesceneProxyl Component) 

indi cesi Componeat ->i ndi ees 

Theater ial [Component ->TheNaterial 

1 

















Vertenbutter = fuyvertextutter 
Indexbuffer = Fay! ndextuffer() 
far (Factor Vertex = Component. »ferti ces) 
t 
Vert ices. ada] Fbysam cWeshvert exl Yertex)) 
' 





» 
amarena 
MMaterial" Thetater 
virtual FPrimitiveVi ewhelevance GetVi ewel evanc 
sceneview View! const override 
1 
Prim ti veli enel evance Result 
fesultbDynam cel evance = true 
Result por ekelevance = trae 
Result. bNormal Transl ucencyhel evance = true: 
teure Result 
à 
Virtus vol Get Dynami cMeshël eneste( const TArrayeconst 
Fscanevi ew oe Viens, const FScenevi enam Iya Vienam Iy 
iat? Visisilitymap, FheshElementCal lectori Collector 
1 
for (imta? Viemndex 
Yen edere 











0: ien nden < Views. Numi): 


Foyaami cHesbui der Meshell der: 
i (vertices. Num} == D) 
i 
) 
Weetbui ter. kadierti ces( Verti cos] 
Wessbul ter. kddTri angl es(i ndi cus] 
Wessbul I ger. Get Meshi atris Identity, new 
Fealereshatert at Rengerfrony( Theater al 
DGethesder rony| alse). Li mesrtel ort: Gray) 
Getdeptaprl orityoraupl Vi ems[ view aden}, true, true 
Wewlader, Collector! 

, 





int32 FnySeenerronyss GetWemaryFootprint| vol dl const 
Berride 

' 

return sistit 


D 
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virtual -fuyScenePrany(1 1) 
private: 
Tarray<t Dynami cueshtertero Verti ces 
Tarray<i nt3» Lal ces 
Fyvertendut er Vert extatter 
PMi ndexBut ter (nderit er 

n 


4. Our scene proxy requires a vertex buffer and an index buffer. The following 
Subclasses should be placed above the Scene Proxys implementation: 
class Phyvertertuffer : public Fvertexbuffer 
t 

public 

Tarcayetvecter> vertices 

virtual void Init) override 

i 
FAN Resourcecreatelafe createl fa 
VertenBufterkll = RH Crest eVertenbof ter | Verti ces. lom) 
"sizeof (#Vector), BU Static, Createl ata): 
void! vertenButferoata 
Ral LockvertexbutferivervexBufferRHl, 0, vertices. teat) 
* sizeat(#Vector),RLILW 208 y) 
Femar y: :Mencpy( VertexbufferData, Verti ces. Get etal 
Verticis um] s sisesti actor) 
Aunt ackvert exu er Vert exbut er). 








D 
y 
Class By nderotter : public Fiadextutter 
f 

public 


Tarray<i nt» tai ces 
virtual volg Init) override 
1 
Fil Resourcecreatel fe createl fe 
I adevbutferBhl.= Ral reste ndexBuf (sizeof (2122) 
indices Ment) * sizeof [rnt], SUP Static, Createl aio) 
void? duffer = RHiLoct/ngesaufter(TngenautterRal 8. 
Trai cei enl) * sient Iint32), RLAL wr 2089) 
Piemry: <Wencpy( But fer, Indices. Get ata), 
Indices: ent) > sient inti) 
aun! ock! ndexbuffer (1 ndenBuf rR | 
D 
i 








5. Add the folowing constructor implementation: 


Uunymesncompanent: Unyseshconposent | 
t 


statie ConstructorHel persi: bj ect Fi ader lateri ai 
Material TT 

[water al") Engi nef Basi cShapes Basi cShapeWater al **)] 
if (Material. object! MULL) 

1 

Theweterial 
) 

Vertices. Ma] Plertor 1t, 0, 0l): 
erti ces. dé] FYecter|a, 10, 0l): 
ertices agl Pertor t; 1, 1] 
Indices kas 

Indi tes Ada), 
Indi tes Adal 2), 
ł 


6. Veritythat your code looks like the folowing: 
torayma once 





IUaterisl aterial -Obj ect: 





#i nci ude “Conponents/ MeshConponent. ht 
#inci ude “MyNeshconponent generated. b+ 


UcLASS|ClassGroup = Experi mental, meta 
(Blueprint Spawnabi Component )) 
Class UEACOOKBOOKLAPI UNyMeshConponent : public 
Ueshcompenen 
t 
sENERATED, eoori 
public 
Virtual FPrimitivesceneProxy* Crestestenetronyi) 
feriae 
Tirrsye sti» ladi ces 
Tarrayetecter> Vertices 





UPROPERTYL Efi tAnywhere, Blusgri eReasmrize, Category 
Materials} 


MMaterial" Theater 
Iiyweshcorganent) 


sel ade “Uesceokoeok. ht 


clade *MyNeshcanponent . h 
elude elersentactary. o 
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Components 


Acl ude “Dynami ceshbui I der. h 
ass FAyvertendutfer public FVertexbufter 


public 
Tarcayetvecter> vertices 


virtual volg Init) override 
i 
Fil Resourcecreatel nto createl fe 
VertenBuft rk = RH CrenteVertendstfer 
(vertices Wum} © 
SitestIFlertor], SUF static, Crestelatel 


voids Vertenbetferpate = 
Ral LockvertexbutferivervexbufferRHl, 0, Verti ces. tat) 
© sizeat(#Vector), Ri I tebni y) 

Fema :Mencpy( VertexbufferData, Verti ces. Get Data 
Werth ees. um] $ sisesti actor) 

Aunt ackvertexau er Vert exBut Ter). 


D 





ass FMyindexButter 5 public Hindentutter 


public 
Tarray<i nt32> Ladi ces 


virtus volg (ai EAH) verri de 
1 
Fil Resourcecreatel fo createl fe 
IadevbutferBhl = Ral createl ndexBuft (si zeaf (2122) 
indices Ment) * sizeof [rnt]. SUP Static, Createl elo) 


void! butter = AH Lock nderut er nderiut eril, 8, 
Trai cei Ment) * sient Iint32), A etri y) 
Planer MemcpylBstter, Indices. Geč batal) 

erc ent) > sizes! lint) 

aun! ock! ndexbuffer (1 ndenBuf rR | 


D 
ass HjStenebrory : public FPrimtiveSceneProny 
pubiic: 


FiySceneFroxy(WyNeshConpenast® Component | 








FoeimtiveScensPresyl Component) 
indi cesi Compenest->i ndi ces] 
These eral Component -»Theloterl al) 
' 
Vertenbutter  FhpVerterhutferll 
Indexbuffer = Py ndexbuffer() 


far (Factor Vertex : Component s¥ertl ces) 
t 
Vert ices. adal Foynami ceser t ex( Companen 
>GetCamponentLacati ont) + Vertenl 
, 
D 


monet) 
MMaterial" Theaterial 


jetual Primiti veVi ewhelevance GetVi ewel evance 
Fsceneviewt Viem const override 

i 

Prim tivevientel evance Result 

Aesul t bbptam ther evance = true 

dens t abr sekelevance = trae 

Mesul t.bNormal Transl ucencyhel evance = true: 
rure Result 


D 








situs vals Getbynameseshel eneste( const TArrayeconst 
Fscenevi tw oe Viens. const eSceneVienfam Iya Vienam Iy, 
iat? VISIBLE yag, FMESHel emen Cal lectori Collector 
konst override 
1 
for (int32 View agen = 0; View aden < Views. Numi): 
í 
Foyaami cWeshbui I der eshbull der: 
i Verti ces. Num) 
D 
à 
Weetbui ter. kddierti ees Verti ces 
Westbui I der. AdaTri angl es( ndi ces] 
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MeshBul I der. Get Mesh| Fatri x: Identity, new 
Feal ereshatert ai Render Prony( Theater! al 
SetheszerProrrl aise). fLisearcel r+: Gray) 
Get Dept Pri ari tyGr oup! evi View! den] 
true, true, Viemnder, Collector] 





, 
D 


ald FuScenePrany::OndcterPasitionchanged{) override 
1 

Vertentuf er kel easeRessur el) 

Indesbuffer. ReleaseResourcel) 


D 


aita EysceneProxy:: etvemeryFect pri rt Leni d] const 
ferias 
1 

tetura sint 

J] 
virtus -FiyScesePeany() 4): 
private: 
Tarray<# Dynami cesherter> Verti ces; 
Tarray<i nt32> Lal ces 
Fayvertendut fer Vertexbafter; 
Fai ndexBut fer (ndexBuf er, 

n 


FPrimtiveSceseprony* unyseshconposent :CrestescenePreny() 
( 

FreimitiveSceneProxyt Proxy = ML, 

Prony = new FAySceneFroxyi this): 

return Proxy 

i 


Uunymesnconpanent: : UNyMeshconponent || 
( 
static Const ructorHel pers: :FOb] ect Hi ader lateri alo 
Material TEXT 
TMteri b] Engine] Basi céhapesi Basi cétapelateri al **]] 


if (material object t= MULL) 
' 
Theneterial 


D 





Iüaterisl ater al -Obj ect 








Vert ces. aaa] Flaetorl 0, 0, a] 
Vertices. aga] Flaeterl 10, d] 
Vertices Adal Paeterl t, 618) 
Indices kid 
Indices haa 
indices ktdl 

i 


T. Create an emplyictor in the editor and add the new mesh component to lt to 
Sco that your l'angle is rendered Experiment by changing the values added with 
Vertices. Add and see how the geometry changes afler a recompile. 








1. inorder for an Act or to be rendered, the data describing it needs to be made 
accessi lo the rendering ead 

2, The easiest way to do this is with a Scene Proxy-a proxy object that is created on the 
render thread, and is designed to provide thread safety to the data transfer, 

3, The?rimitiveCospanent dass depnesaCr eat eScenePr oxy function that 
retums FPr i mi ti veScenzPr oxy" This function allows custom components 
ike ours to return an objectbased on FPr i mi ti veScenePr oxy, leveraging 
polymorphism. 

4. We dene the constructor of theScere?r ony object to take in an instance of our 
component so that each Sce nePr oxy created knows about the component instance 
itis associated with, 

5. That data is then cached in the Scene Proxy and passed to the renderer using 
Get Dynami cheshEl ements 
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6, We createani ngexBut Fer anda Vert exBut er Each of the buffer classes 
‘we creste are helpers that assist the Scene Pros ith allocating platform space 
memory for the two buffers. They do soin the | ni t Ral falso known as Initialize 
Render Hardware Interface) function, wherein they use functions from the RH API to 
Create a vertex buffer, lock it, copy the required data, and then unlock it. 

7. Inside the components constructor, we look for a material asset that is built into the 
engine with the Obj ect Fi nger template so that our mesh wil have a materia. 

3. We then add seme vertices and indexes to our bles so that the mesh can be drawn 
hen the renderer requests a Scene Pro 





Ani aventoryConponent enables its containing ctor tostore I avent aryAct or s in its 
inventory, and place them back into the game world. 


Getting ready 


Make sure you've followed the Ais Mappings ~ keyboard, mouse and gamepad directional 
input for an FPS character recipe in Chapter 6, Input and Colision, before continuing with this 
recipe, as it shows you how to create a simple character, 


Aso, the recipe Instantiating an Actor using SpaenActr in this chapter shows you how to 
create a custom Gaze Wo de. 


How to do it... 


1. Create an Act or Component subclass using the engine called 
Thventary Cenpenent, then add the following code to iE 
inerti 
Tarrayehl event eryictur*» Currestlaventery 
Funct om 
18132 AddTal nventary(Alnventoryāctor" Actor Tease 


utuncri ont 
void Remvelroni nventery A nvestorykcter* 





ctorTeleravel 


2. Add the following function implemertation to the source He: 
int32 MinventoryConponent::AddTal vent ory( M nventoryctor* 
ActorThél 
( 

return Currenti aventory. Adal Actor Tonda) 
i 





m 





"m 
UlnvestaryComponeet: -herevefroni evento y mvesteryActar* 
Actor Toħemovel 

( 

Current nvestary. Remove! 
, 


Nert, create a new stati cHeshactor subclass called! aventoryAct or Add the 
folowing to ts declaration: 

virtual void Pickup. 

Virtual vaid PutDoan(#Traestorm Target Lecatl onl 


Inplementthe new functions in the implemertalion pe: 
veld AlaventaryAct or: PictUpl) 


( 
SetActarti ctbrabl edi fal sel 
SetActard déeniséome| trae] 
SetActarEnasleCalision{ fal sel 

i 





ttar Totenovel 





veld Ainventoryäctar: :PutDewn(#Transt arm Target Locati onl 
( 
SetActorti cibnabl edl truel 
Set Actor déenistame| false) 
SetActorEnasleCel isi oni true) 
SetActarLocati onl Target Lecatien.GetLecatien()} 
, 


so, change the constructor to look ike the following: 
Saperi) 
t 
Pri maryActorti ck. beangverTi ct = true: 
auta sheet = 
Construtor Mel pers: FObj ect Fi nder usta Hesh» 
[TEXTI Stati cas | Engl ae Bas l eStapes) Cube. Cube! 1] 
1 (WesaAsset. Object t= muliptr) 
1 
estat cert Componenti 
set Stati ces M Mes set. Obj ect) 
GetStaticueshcompenent | 
Seeteel rst aebrat | came 
(Ucar Ts onProfi les: Pann, Profi ekane) 


) 
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Getstati cHeshtomponent() 
>Set Nabi Ii ty Component Mobi ity: Nova el 
SetActorEnabl ecol isi onl truel 

" 


We need o add ani nvent or jCosparent to our character so that we have an 
inventory that we can store tems in. Create a new Si mp! ehar acter subcase 
using the editor, and add the flining to ts declaration: 

urroneaTni 

UlnvestaryComponeet® yl nventary: 


uruneri 
virtual vaid SetupPlayertaput Component class 
input Coreonert* Input Component] override: 





vrincrioni 
vaid Dropiten|l 
ener out 


aventoryactor® Inventory ten) 





virtual void Woti pH tIclass rri m ti vetomponest* MyCom, 
actor” er, class Ubri mt vetomenest" ther Cone. Baal 
Self Maves, FYectar HitLecstias, Flector HitNormal, Pictor 
Matma! inpaises const FAitResul tk MIT) override 


éd this Ine to the character's constructor implementation: 


Myinventory = 
(Crastebef aul abet] ect <u aventaryCanponent>l inventory") 


‘dd this code to the overriden Set upPl ayer Input Component 
vaid AlnventeryCharacter-:SetugPl ayer! aput Component cl ass 
UinputComponent* Input Component | 
( 

supers SetusPl ayeri aputCenposent | pet Component) 

Input Component- »Bi ndacti ont" opl ten" 

Elnputevent "le Pressed, TMS 

kil eventor Character: i Oropi ten 
' 


Finally add the following function implementations: 
vaid AlaventoryCharacter::brapitemi| 


( 
Lf Dg avent ory- >ur rent Inventory. Kon] 


i 











D 


Alnventarylctort Item = Wyinventory 
Scurrentlaventory. Last] 

Myl avent ory- »hemoveF romi event ery| tem 

Flectar Itembrigin 

Fuector ItenBousds 

tes >Getactorbaunds| false, Itenbrigin, Itenbeunds] 
FTeanetarm PutDawnkacation = GetTranstorml} + 
FIranstarm Rent Component -»Get Fer werdvect atl) * 
Itentousée Getta] 

Item aPat Doan Pat DoanLacet ie] 
i 





Vaid AinventoryCharacter:: Noti yh t] class Ubri siti veComponent 
tere, Meter! Other. class Uer m ti vetomoenest* ther tans, Baol 
thet fioves, Fvector HitUecstian, Fvecter miharnal. Flector 
Marmalinpaise, const FHithesult& Hit) 
( 
Mnventerykctor* Inventoryitem 
Cast «al sventeryactars( Other]: 
IF imertarsitem t= nul lptr] 
' 








Titel tent ventory teml 


D 


4 Mnventorytharacter: Takel teni A mventoryáctor* 
entoryi tem 





Inventory! tere shi cio 
Wl sventery:»hdéTel event ery inventory teml 
i 

20. Compile your code and test it in the Editor. Create à new level and drag a few 
instance afi nvent or pictor out into your scene. 

11. Refer to the Inctantating an Actor using SpawmActr recipe f ou need a reminder 
of how to override the current game mode. Add the following ine to the constructor 
of yaur Game Mode from that recipe, then set our levels Ga ea $e to the one you 
created in that recipe: 

Defaut tPawnClass = Alaventoryc 





acters: stati ctlassl); 
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Actors and Components 
12. Very your code against the listing here before compiling and launching your projet. 


tpragma once 


#i ncl ade *GameFramework/ Character- a" 
tcl ede “Inventory Component. 
s ntl ide “laventaryCharacter. generated. b+ 


ucassl) 
Class UEACOOKBOOK_APL AlaventaryCharacter : public 
character 
t 

ceneraTen soov) 


public 
AlnventeryCbaracter{ 

virtual val d BeginPiay) override 

Virtus volg Tiekl float Deltaseconds } override 
Virtual vaid SetupPi ayeri nput Component (class 
Input Corpasert* InputConponent) override 


uraareary() 
WaventarsConposent® Wylnvent ery: 

urnarear¥() 

Ucaneraconponent® Nai nCanera 

[o 

ald Titel teri A nvestorpkctor* | eventeryi teml 
truer! ok) 

val Drapi tent); 

alg MaveForwardl float Axi sValue) 

alg Mave ght (tl oat Ai sVal ee) 

Yoi PitchCameral fiat Axi sValue) 

alg Yantamera(t loat Axt sVal ve) 


arwen on) 
virtual volé Moti yAlt (clase UPri miti veConponent* Meme 
actor’ Other, class UPrimitivaComponent* OtherConp bodi 
ssi Naved. Fiectar AltLocati on Plactor sie Mer ml 
Fvectar Normal impulse, const FMirResult Mit) override; 
private: 

Frectar Movement I npat 

Fvectar cameral aput 


clude *UEACookbook: h 











nel ade “Inventorycharacter. 


ALnventorytharacter::Alaventarycharacter() 
super!) 
t 
Pri maryActorti ck. Gebiet = true: 
Wimeentery 
CreateDet sd! T Suboh] eet el nvastaryComenest> 
T Mr venta?) 
Wai atamera = CresteDef aal Subeh ect <UCameraConponent > 
Mngt nCanera*} 
Mal sCamsra-stUseFawsContraletatien = 0 
, 


vaid AlaventoryCharacter:: Begi aPlayl) 
t 

Super: : begi aPl ayl) 

Mal sCamsra-okttachTa| st Component): 
" 


Vaid Aimventorytharacter:iTick| float DeltaTime ) 
( 

Super:: Tieki DeltaTime | 

IF (t Navementi aput 122721) 














i 
Navenentl aput *= 100; 
Fvecter laputvecter = Feeter(9, 09) 
legit etur e Get ActorFereardvectarl)* Wovemeati ngut- X 
a Del t aTi me: 
Laputvectar 42 GetActerdigatvectar{|* Movementi nput. Y * 
beltetine 
Get har act erWavement(|->tdal nput vector {I npat Vector] 
Engl se >4ddOnScreenDebughessagel s1, 1, FColor:: Red. 
Fettiagicrrimti(tent(n My, yew E 
SET UmpurVectorX, Lapurvectar., inpatvector.2)): 

) 


Lf 4t cameral spit. Lear yZeral)) 

1 
Rotator Newhatation = GetActorRotati onl) 
Newer tian Pitch +e Cameralnpet. Y 
Newkot stan. Yaw +e Cameral aput X 
AtiayerCantral ier” myPl ayer Control er 
Sata ayer Control erat et astra er (|) 
Te ful apercantrel ler = aull str) 
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t 
WPi ayer control er- »4ddYani ngut ( Cameral ngut- X| 
MyPL ayer Control Ier- >AddPi tent nput | Caner at nput.1) 
] 
Sethetorhotati on(Newtatati ani 
à 
] 
Vaid AlnventaryCharact ers: SetugPl ayer! aput Component cl ass 
Uinput conponeat* Input Component | 
( 
Superi Setusbl ayer aput Component | I pet Component): 
Lagat Component ->Bi nén s] NoveForwaré*, this, 
Vil avent oryéharacter:: NaveFar mard! 
Lagat Component- >Bi ndAxi s| Novetight*, this 
Vil avent oryéharacter:: vel! ght) 
InpatComponent->Bi ndAxi s| "CameraPi tch", this, 
Wilsvenserycharacters:Pitehcanera) 
Input Component- >Bi ngáxi s| "Camerata", this 
il avent or yéharacter:: Yawtamera); 
Input Component- obi ngáct i onl" Oropi tent 
Elaputevent 1E Presset, This 
kal event erychar deter! Oropi tEn: 








] 
Vaid AlaventoryCharacter::bropitemi| 
t 
1E (nyt avent ory- atur rent Inventory. tual) 
1 
) 


Alaventorylctor® Item = Winventery 
sCurrestlventery. Lott | 

Wi avent or y- »RemoveF romi nventor y| ten] 

Flecter Itembrigin 

Fvectar ItenBousés 

Item >Getdererdaunds| false, temdri gia, Itenbeunds] 
Fieanetarm PutDawnkacation = GetTranstorml} + 
Franst arm Rent Conpanent »Get Fer weravectar() * 
Ttenbnusss. Geta] 1 

Item oPat Doan Pat DoarLacet ie] 


i 
Vaid Mimventorytharacter: Moveforward(fioat Ari sal ue] 
t 
Woserent spat. X = Plath: i Cl ampet i eat) Axi sValue, -1 0f 
rail 








, 


veld AlnventeryCharacter::oveRi ght | eat Axi sYal uel 
( 
Movement input. Y = Fathi: Clampett eat axi sValue, -1 0f 
rat 
, 


veld AlnventeryCharacters:itencamera( leat AxisVal ve) 
t 

camera aput- Y 
i 
Vaid Ainventorytharacter: :Yawtaneral float Ari sYal uel 
t 

camera aput- x 
i} 
vaid AlaventoryCharacter-:Natl fylti class 
Urrimtiveconponcet* MyComp, AActor* Other, class 
Utimtivetompeneet* other Comp, bos! Bselfitoved, Fvector 
HitLocatian, FVector aithornal Flector. Normal impulse, 
Const PH essit Mt 

t 

AlnventoryActor® Inventoryitem 

Cast eal aventoryact oral Ot her): 

if (laventeryltem t= nul ptr] 


i 


) 
] 
aid MnventoryCharacter: :Takel tem Al entoryactor* 
event oryi temi 

Inventory temor cho: 

Myl avent ary- »AdaTol aventoryli nveatoryi ten] 
1 











Takel tent ventory ten) 


trap once 


acl ude “Comonests/ Actor Component h* 
fiche "Inventor rhetor n 
#inciude "Inventory Component. generated. b+ 


UcLASSI CLasstrougel custom) 
metasi Bi uepri atSpawnableCemponent) | 
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tlass UEACOOKEOOK_APIUlnventaryComponent : public 
UActartomponent 


sENERATED, soov) 


pubiic: 
Waventersconporent 
virtual volg Ti chComponent( float Del afi ge, ELevel Tick 
Viekiype, Factor ComeonestTictFunet ian? Trish ekfonetion | 
verri ae, 





upaareary() 
Taray ai renta pieter* Current! ventory 


uFUNET/ ON) 
Tat? AtéTat nventoryl al eventorphetor* ActerTeadd] 


arwen on) 
ald emtvefrom nvestory|AlaventeryActor® acterTateme) 

y 

Fi ncl ade “uesceokeenk. ht 

Hine ade *inventoryCamponent. h 


U nventoryComponent:: UlaventaryComponest() 


( 
iteteegi lay = true 
Pri mar Component Ti ci. CanEverTi c 





eld inventor Component: :TickCompanent| fl eat Del taTi me, 
Eleveltick TrebType, FActerCompaneat Ti chruacti ont 
TalsTickFunct! on | 
t 

Super: :TickCompanent | DeltaTi ne, TickType 

TT euruncti es T 
i 


| a132_ubnventoryComponent AdéTol entery( M nventoryctor* 
Aetarrondal 


return Currentiaventory. edi Actor Todd): 
i 


vaid UlaventoryComponent:: RemaveFromi nventary 
(Alnventerytctor* acter Tekenovel 


Current nveatary. Remove kctorToReravel 
" 


tpragm once 


#i ncl ade *CameFramewor kí Ganevege. h“ 








a. 


Chapter a 





ucussi 
SENERATED, BODY] 








finc ede "Manestate h" 


AUEeCaobbockGaneNode:  AUECConkBenk Gare | 








Last we need to add cur! nput Act ian to the bindings in the editor. Todo this, 
"ring up te Project Settings.. window by selecting Edi | Project Settings, 
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14. Then we can hit play, walk over to our inventory actor, and it wil be pick 


Then, select Input on the lefthand side. Select the plus symbol beside Action 
Mappings, and type Dr sp1 t em into the tent box that appears. Undemeath tis a lt. 
of ali the potential keys you can bind to this action. Select the one labelled E. Your 
Settings should now look Ike the folowing: 


Engine - Input 








up. Press 
E to place the actor in a new location! Test this wth multiple inventory actors to see 
hat they all get collected and placed correctly. 


How it works 


1 


ur nen component contains an array of actors, staring them by pointer as well as 
declaring functions that add or remove tems tp the array These functions are simple 
rappers around the TAr r ay add remave functionally put allow us to optionally do. 
things such as checking lf the arrays within a specbed sie mi before going ahead. 
with storing the tem. 
I nventeryAct ar isa base class that can be used for all teme that can be taken by 
a player. 
Inthe Pi cè up function, we need to disable the actor when It is picked up. To do that, 
we have to do the following: 

E Disable actor ticking 

«o Hide the actor 





Disable colision 





Chapter à 

4. We do this withthe functions Set het orTichEnabl ed, Set Act ari dden name, 
fandSet ket erEnabl Cal ri sion 

5. The Put Down function is the reverse. We enable actor ticking, unhide the actor, and 
then tum its colision back on, and we transport the actor to the desired location 

6. Weadd ani nenteryComponent t our new character as well as a function to take 
items, 

T, In the constructor for our character, we create a default subobject for our 
1 mentor ytemponent 

B. Wealso add atti! ji t override so that we are natiped when the character hits 
othe Actors. 

9. Inside this function, we cast the other actor to an invent or yAct othe castis 
successful, then we know our Act or wasan invent or Act or and so we can call 
the Takel t em function to take iL 

10. In theTakel tem function, we notify the Inventory item actor that we want to pick it 
up, then we add it to our inventory 

11. The last piece of functionalityin the avent or yCharact er is theDr opi tem 
function: This function checks if we have any tems in our inventory. If it has any 
items, we remove t from our inventory, then we calculate a safe distance in front 
of our player character to drap the item using the lem Bounds to get ts maximum 
bounding box dimension. 

32. We then inform the item that we are placing iin the orld at the desired location. 


See also 


= Chapter 5, Handing Events and Delegates, has a detailed expanation of how events 
and input handling werk together within the Engine, as mell as a recipe or the 
Simpl eChar acter cass mentioned in this recipe 

Chapter 6, Input and Colision, also has recipes concerning the binding of input 
actions and axes 











itingMovement Componi 





‘This components simiarto ot ati agNevement Component in that itis designed to make 
"he components parented tot move in a particular way. In this instance, wll move any 
attached conperertsin an orbit around a ped pont at a ped distance. 





This could be used, for example, for a shield that orbits around a characerin an Action RPG. 
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1. Create nen Scene Component subclass and add the folowing properties tothe 
class declaration 
nm 
hus RotateTafaceðutuards: 
p 
fiat datatieetpeet 
inorermri 
fiat Orbi ti stance 
float Current value 


2. Add the following to the constructor: 
s: 
108 


Ratati onspees 
orbitoistance 
Carrestvalue = 0 
Rotateroraceostwards = tree 





3. Add the folowing code to the Ti ck Component function: 
float Current va vel akadi aes 
Fusth:DegreesTakad! aas <t! sat >| current Valve] 
Sette atl veLecatl en Fvecterl rbi tbi stasce * 

Figth:Coe| Current al el nkadl aes). OFB EDI stance * 
Fusth::Sta| Current Val el nkadi ass) Relativelocati on, 2)| 
1E (RatateToFacedst wards) 
t 
vector Lontbir = (Relativekorati on). Get Sat elor mal (): 
Fat ator LoskatAt = Loaknir. Rotation): 
Setel ati vetotat i onl Looktát Rat | 
i 
Carrentvalue = FMath::Foud| Current Value + (Rotati onSpeedt 
DeltSTi me) 380) 








4. Verity your work against the following listing: 
fteragm once 
#i nci ude “Components! SceneComponent b+ 
finci de “Orbs tingere Component. generated. n" 


UcLASSI cl assGroupe( Custom 
metasi b uepr int Spawmabietonponent) | 

Class UEACOOKBOOKLAPI Vorbiti ngMovenentComponent : public 
Uscenetonponent 





sENERITED, eoori 
public 








J) Sets default values tor tals component's properties 
Uorsitiaghovemest Component) 


J1 called ten the game starts 
virtual vold Regi nay] override 

Ji called every Trame 

Yirtual vold TickComponent{ float DeltaTive, ELevel Tick 
TWettgpe, Petar cangonstT ctfunt lon? Tarshifonetion 1 


nu 
ies RotateToFaceout waras 
uPagrear() 
Haat aatatenspeed 
upaagrear¥() 
Haat orbitolstance: 
Haat correstialue 
k 
Fi ncl ade “UEtceokeeok. ht 
#inci ude “Orbi ti ngWovenent Component .h* 
Il Sets default values for this component's properties 
UOrbitingMovement Component: Orbi ti ngNovement Component || 
( 
1 Set this comonest to be initialized when the game 
Starts, and to be ticked every frame. Tou cae turn These 
features 
Hi aif to improve performance if you don't need them 
Metstesi Play = true 
Pri meryConpanent Ti ci. ACanEverTi ck 
fotatianspeee = $: 
Orbitoistance = 100: 
Currentvalue = 8 
otateraFaceoutmards = true: 


$ 





|) Called when the game starts 
vaid UOrbitingNovenent Component: : Begi nPI ayl | 
f 

Super: : Begi Flay) 
, 
|) Called every trane 
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Wald orbiti nglovenenConganent i: Tick 
Pctarcongones ttik Puatt ant TAI sTickFanctian | 
í 
Superi TickCongonent| DeltaTine, Ti cipe 
Iti cttiset an 
{oat Gorreet Val uel a 
Beth SegreesTo ad 
Sethel st reteest jonl 
Plscturitriitbrstance + Fatai cor 
[elSrant Val ael nadan 
iri tbi stance * Fae 3I nl Current Val uel sadi aos) 
fel stiveLocat/ae.2)) 
1f ietstereracetu naris] 
[ 
fiecter Leskbir = [Relat| veLocst| an|: GetSat enor nal |} 
Fiatater Lookatnat = Lon etate] 
furrent Value = Hats ous Gorrertlat ve + [RotatlanSseea! 
Bel tat me 360) 


1 


5, You can test this component by creating a simple ct or Blueprint. 

8. Aidan Orbi tingovesent Componentto your Actor thon add a few meshes 
using the Cute component Parent them to the Orit gMavement component by 
dragging them on to iin the Components panel. The resulting hierarchy should look 
the the follow: 


orent| float 

















aptera 





Refer to the Creating a custom Actor Component recipe if youe unsure ofthe 
process. 


Hitplayto see the meshes moving around in a circular patter around the center of 
Meier 


1 





forti 
sari 


The properties that are added to the component are he basic parameters that we 
use to customize the circular mation af the component 

Rotat eTařace0ut wards spedpes whether the component wil orient to face anay 
fram the center of rotation on every update. Rotat i on Speed is the numberof 
degrees the component rotates every second. 

Orbit Di stance indicates the distance that the components that rotate must be. 
‘moved rom the origin. current Vat ve Is the current rotation position in degrees 
Inside our constructor, we establish some sane defaults for our new 

component. 

IntheTi ctComponent function, we calculate the location and rotation of 

our component. 

The formula in the net step requires our angles to be expressed in radians 

father than degrees. Radian describe an angle in terms of à We þrst use the 
Degrees eRads ans function to convert our current value in degrees a radians- 
‘The Set Rel ati veLorati on function uses the general equation for cireular 
mation, that is-Posig) «cosi in radians), sing in radians}. We preserve the Zaxis 
Postion of each abject 

The next step is to rotate the object back towards the origin (or else, directly 

amay from t. This is onlycalcuatedif at steTeFaceDit mar ds E true and 
involves getting the relative offset af the component to its parent, and creating a 
rotator based on a vector pointing fom the parent to the current relative offset. We 
then set the relative rotation to the resulting rotator, 

Lastly, we increment the current value in degrees so that it moves Rot at i onSpeed 
units per second, clamping the resulting value between 0 and 360 to alow the 
retatn to loop. 





eating a building that sp units 





is recie, we wil create a building that spans units ata ed ime intera ata 
ar cabon 
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How to do it. 


1 


Create a nen Act or subclass in the editor, as always, and then add the folloming 
implementation to the class: 

vurrorenty || 

UStati cMeshComponent* Bul ldi ngliesh: 

nori 

UrarticleSystenConponent* SpawePol et 





vurorenty|| 
Uclase” Ubi TeSpamn 


pore || 
float Spannlaterval 


utuncri owt 
veld Spaweuni tl) 


utuncri owt 


Vaid EndPiay(const EEndPlayheason: :Type EndPlayheason) 
verri de 


rope) 
Fimerlandle Spausti ertandi e: 


‘the following to the constructor: 
Buil di nglesh = 
Crenteber aul tSubobj ect stati cMeshConpanent >l" Bui | dires 
SpaunPoi v 
rest etel suit subebj ect arti cl eSystemčomponent >l" SpawaPol a 
a 
Spreri nterval = 18 
aio MeshAsset = 
Canstructarkel pers: Fob) ectFi nder <UStat i cNesha[TEXTI "Stati e 
Masi | Engine basi eshapes/ cube Cube") 
1 (Meshasset. bj ect te naliptrl 
t 

Bui iai ngMest- aset Stati cher MeshAsset. bj ect) 

Bui l gi ngMesh- >et Cal isi onProfi l ekamel UCol Iisi onProfi le 

Pawn Profi eane) 





] 
asto Particlesystem = 





aptera 








Construct arte pers:: Fab) ectFl nder <UPart icl eSystem>| TEXTI “Pa 
lel eSysten | Engi ne/ Tutorial Subesi tars) Tatar assets) Tu 
frist Parti clesystem Tutor! partici espstem*)}: 
1t (parti cl eSystem.0bj ect t= aull ger) 
t 

SpannPolnt->SetTenpl atel Parti cl eSystem Obj ct] 
] 
SprenPol et osethet ati veSkale3D| Flector| 5, 0.8, 0.5) 
UeitTeSpam. = Marractiuni i stati eclassi) 








‘dd the follwing to the egi aP! ay function: 
foot Component = Buil di natch 

Stier rt »AttachTo( Root Component 

Sirena et >SetRelativeLocati onl Fvacter] 182, 0, 0)) 


Get orl dl- >GetTi mer Nanager |). SetTi ner SpawnTi mer Handl e. 
this. Mabarracis: Spawn, Spauninterval, Erue) 


‘Create the implementation for the SpawoU t function: 
Vaid Aare acke:: Spaununit (| 
t 
Hector. Spamntocati on 
>GetCanponentLscaton(} 
Geter!) sSpaanactor (Uni tTaSpawn, &SpawnLocst en) 
i 


Implement the overtiden ne? ay function: 
vaid Abarracks::EndPlaylconst EtndPlayhesson: Type. 
Endl ayheasoni 
t 

Super: : Endi ayt EndPi ayheason) 

Get mori al) 

>Geti mer Manager (). CI earTi mer ( SpaunTi mer Hand e) 








Spawapoi at 


i 


Nes, create a en character subclass, and add one property: 
unortim 
Urarti cl eSystenComponent® Visual Representation: 


Initialize the component in the constructor implementation: 
Visual epresestat ion 

Crestebet ult ubob) ect arti cl eSystenconponent >| SpawsPel a 
eI 

auto Parti clesystem 
Constructor el persi: Ob ectFl nder <UPart icl eSystem>| TEXTI “Pa 
let eSyst em | Pagine/ Tutorial {Subedi tors Tatar st assets) Ta 
rial arti eleSystem Tutorial Parti ci eSystem*)) 











m 
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1t (parti clesystem. object t= aul gtr) 
( 

SpanPoint->SetTenplatelFarticlaSystem Ob) ect] 
] 
Speun?oint- Sethe! ati veScale20{Fveetar(9.5, 0.5, 0.5)) 
Speencoll si andanalingiet od = 
ESpauedctor Collis onkandl inghet hod: : Al waysSpaws 


3. tach the visual representation to tho oot component: 
vaid ABareacksUni ts: Begi nPlay() 
t 
Super: : begi lagi) 
SpannPai nt->ttachTal Roat Comeenent] 
, 


9. Lastly add the folowing to the ick function to get the spawned actor. 
moving: 


SetdctorLecat on(etActorLocaton(| + FVector(10, 8, UI 


10. Verity against te following snippet, then compile your project. Place a copy of the 
barracks actor irto tpe level. You can then observe ie spanning the character at bed 
intel: 


teragme once 
incise “Gamefcaneuort Actor. i" 

finci nde “Barracks. generated. 

Uetassi) 

class UEACOOKBOOK_APL Barracks : public Actor 


sENERITED, eoori 
public 

Ataras) 

virtual void BegiaPlay) override 

Mirtusl vola Tiek float Deltaseconds } verri de 


uraareary() 
stati ceshcompanent® Bul dl agMesh; 
uPagrear() 

Uarti cl eSystenonpanent® SpawnPai at 


uraareary() 
chats” Uni sTese 





umoreno 








Haat spamni terval 


arwen ono) 
void Spamnuait() 
FUNTI okt) 


ald EndPlay| canst EEndPlayheason:: Type EndPi ayheasonl 
Hn 


urnareary() 
FTinerHandle SpawnTi ner Handl e: 
k 


mE 
finci ade “BarracksUni tse 
finci ede “Barracks. h" 


1) Sets default values 
dnas aberrant 
t 
I Set this actar ta call Tick() every frame. Yau can 
ura this aif ta improve performance 
1 you don't need | 
Pri maryActorTi ek, bcangvertTi ck = true: 
Bui li aghess 
Ereatebet aul tSubob] ect tst ati cHeshcomponent> 
LBi impleri 
SpanPoint = 
{feateDet aul tSubob ect <UParti cl eSystencomponent> 
Tsspeunzat ae") 
Spann acerval 
auta Meshasset = 
Construtor tel pers: Fob) ect Fi nder «UStati Hesh» 
TEAL Stati enes (engine Bas l eStapas) Cubes Cube! =): 
1f (WesnAsset. Object t= mull ptr) 
' 
Buil di nates set stati evesd| WeshAsset. ob) ect 


eile: ng stet coll si en?rat ela 
Utoli islanprati les: Pawn Profil ekam! 








) 
jute Particlesysten = 

Constructor Hel pers: FOR) ect Fi nger darti cl eSystem> 
TEXT Partici esystem (engine) Tutorial 

susti ters) Tutorial assets 

Teri atrarti el esystem Tutorial Parti clesystem “1| 
It (Part iclesystem Object e mul gtr) 








m 
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1 
SpaunPoint->Set Template Parti clesystem Obj ect) 

) 
SpannPoint->Setelativescale30(F¥ecter(0.§, 6.8, 6.51) 
UnieTeSgeun = ABarrackeUnit Stati cclae8 

i 

Vaid ABareacks:: Begi n?lay(| 

( 
Super: : Begi aPl ayl) 
Ront Conpenest = Bul lal nghesh: 
Spana, rt ott aet Tal fost Component): 
SpannPoint->Setael ativeLecatien(Vecter(2$0, 0, 0l): 
Get mer! £j] stet Ti mer Manager (1. Set Ti mer( SpawnTi mer Handl e, 
This, aAbarracks: SpawnUni t, Spawni nter val, true) 








i 
veld ABareackss:Tick( Heat DeltaTine | 
( 

Super:: Tieki DettaTime | 
i} 


Vaid Abarracks:: Spaunusit{| 


Hector. SpannLacatl on = SpawaPoi at 
>GetCamponent Location) 
Get Worl a} >Spannact or (Uni tTaSpawn, &SpawnLocsti en) 
i 


vaid Abarcacks::EndPl ay(const EEndPlayheason:: Type 
Erit ayteasoni 
t 

Super: EndPi ayt EndPi ayheason) 

Get mori al) 

SGetTi mer Manager (). CI earTi mer SpaunTi mer Kandi e) 
i 


torayma once 


incl ade *GameFramework/ Character." 
finci ede “BarracksUni t. generated M 


ucassi) 
clase UEACOOKBOOK_API AðarracksUnit : public Acharacter 


cenenarep_6001() 








public 
‘arr acksunit1) 


virtual void Regi aPlay() override 
Mirtusl vola Tek! float Deltaseconds ) verri de 


Yi rta void SetupPi ayeri nput Component. 
class UlnpetComponent* Input Component) override 


urnareary() 
arti cl eSystenconponent® SpamnPoi at: 
n 


mE 
nel age “BarracksUni tse 


aparracksUnitssABarractauelt() 
t 
Pri maryActorti ek. bcangverTi ck = true: 
SpannPoint = 
featedel aur tSubob ect <UParti ct eSystenconponent> 
spzuntal at") 
auta Particlesysten = 
Constructor Hel pars.: Fob) ect Fi nger eUParti cl System. 
ITEXT" Parti cl Syst er (engine) Tutorial 
JsubEdi tors) ut otl a Assetaf Tater! al Parti clesystem 
uteri al Partie! eSpetem 1) 
it Part iclesystem db) eet t= nul pte) 
i 
SpaunPoint->Set Template Parti cl eSystem ob] ect) 
) 
SpannPoi nt->Set Ael at i veScala20(Fecter(9.5, 8.5, 6.51) 
SpannCot Iis? onHandl ipti hod 
ESpawnactor coli isi onbandl i get neg: AL ways Spann: 
] 
Vaid ABareacksUni ti: BegiaPlay() 
t 
Super: : Begi aPlayl) 
SpannPoint- ttt achTa| Raat Coneenent 
i 


veld ABareacksUn ts: T/ck( float DeltaTine | 


t 
Super: :Tickl DettaTime | 
SetActarLocatlas| GetActarlocatioal) + FYecter|10, 0, 0)) 
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Actors and Components 


] 
ald Marracksini ti: SetupPl ayer! nput Component (class 
UinputComponeet™ | nput Component | 
( 

Superi Setusbl aperi nputCenposent | I pet Component): 
" 


1 


Fist we create the barracks actor We add a particle system component to indicate 
here the new units wil be spawning. and a static mesh for the visual representation 
ofthe buiding 

Inthe constructor, we initialize the components, and then set their values using 
Fobj ect Fi nger . We also set the class to spawn using thet ati Class function 
to retrieve a UCI ass" instance from a class pe 

IntheBegi nP ay function of the barracks, we create a timer that calis our 

Spawn Uni function at ped intervals. We store the timer hadein a member 
variable in the cass so that when our instance i being destroyed, we can halt the 
"mer; otherwise, when the timer triggers again, wel encounter a crash where the 
object pointer is dereferenced. 

‘The SpawnUn t function gets the word space location ofthe SpawnPoi nt 

object, then asks the wori to spawn an instance of our unit class at that location 
Bar racksuni t has code in its Tick) function to move forward by 10 units every 
‘tame so that each spawned unit will move to make room for the next one. 

TheEndP I ay function override calls the parent class implementation of the 
function, whieh is important If there are mers to cancel or deinitialzation performed 
in the parent class. R then uses the timer handle stored in Segi nPI ay inorder to 
cancel the imer 





Handling Events and 
Delegates 


Unreal uses events for notifying classes about things that happen in the game world in an 
'eftcent ranner. Events and delegates are useful to ensure trat these notipeations can be 
issued in a way which minimizes class coupling, and allows arbitrary classes to subscribe to 
beret 


We wl cover the following recipes in this chapter: 
^ Handling events implemented via vial functions 
= Creating a delegate thatis bound to a UFUNCTON 
= Unregistering a delegate 
= Creating a delegate that takes input parameters 
= Passing payload data with a delegate binding 
satinga multicast delegate 
= Creatinga custom Event 
satinga Time of Dayhandler 
= Creatinga respouring pickup for an First Person Shooter 








functions 





Some Act or andCospenent casses provided with Unreal include event handlers in the 
form of virtual functions. This recipe will show you how to customize those handlers by 
overriding he virtual function in question. 








Handing Events and Delegates 


How to do it. 


1. Create an emptyac t or in the Editor Calli I Tr gger Vol une 
2. Add the folowing code to the class header: 


nm 
Usoxcenposent™ Tri ggeržone: 


utuncri ont 
virtual vaid NotifyäctorBeginüverl aplAActar® Other Actor] 
averti de: 

rici on 


virtual vaid Moti tyActorEedoverlap|Alctor* thersct or) 


3. Add the implementation for the preceding functions to the cpp He 
void AMyTriggerVol ume: Noti yactorBegi sover lapl Adctor* 
OrnerAetor| 
t 
Engl ne- »addOnScreenDebughessagel-1, 1, Fol er: Aed, 
Estr ing: Pri mtf (TEXTI "MG entered me) 
Nother Actor: »ethase TIT 

i 





Waid ANT? ggerVol une: Not yActor£ndtverl pl Mctor 
rerktterl 

{ 

GEngi ne- »AddOnScreenDebughessagel-1, 1, Colar: : Red 
Estr ing: : Pri RUTERTI e Left me], *lOtBerActor 
Ep 

1 


4. Compile your project, and place an instance of Tr gger Actor into the leel. 
Verifythat overlap touch events are handled by walking into the volume, and seeing 
the output printed to the screen: 
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As ales, ve frst declare aUPROPERTY to hold a reference to our component 
Subabject We then create to UFUNCT! ON declarations. These are marked as 
‘virtua! andover ri de so thatthe compiler understands we want to replace the 
parent implementation, and that our function implementations can be replaced 
mum. 

Inthe implementation af the functions, e use FSt ri ng: -pri st! to create an 
Fst ri ng from some preset txt, and substitute some data parameters, 

Note thatthe String Ot her Act or- »Get Name | retums, and is derelerenced 
using the operator before being passed inta F St ri ng: Far eat. NoLdoing his 
tesults in an error, 

‘This Fst ri ng is then passed toa global engine function, 
AddonSereenDebughessage 

The fst argent of els the engine that duplicate strings are allowed, the 
‘second parameter is the length of time the message should be displayed for in 
Seconds, the third argument the color, and the fourth 1s the actual string to 

print isl 

Now when a component of our actor overlaps something else, Is Updat ever! aps 
function il calet {yet or Begi river | ap, and the virtual function dispate wil 
‘cal our custom implementation. 
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bound to a 





UFUNCTION 


Delegates alow us to calla function without knowing which function is assigned. They area 
‘safer version of a ram function pointer. This recipe shows you how to associate a UFUNCTI ON 
toa delegate so that Ris called when the delegate i executed 


Getting ready 


Ensure youve followed the previous recipe in order to create a Tri ggerValune cass 


How to doit... 


1. Inside our Game Mode header, declare the delegate with the following macro, just 
before the class declaration: 
DECLARE DeLecare( sea 
cassi 
class UEACOOK800K 





arddel agatesi gnature) 





| AUEACookbookGameðode : publi 


2. Add a new member to our game mode: 
FstandarddelegateSignature wyStandardDel egate 

3. Create a new Act or class called Del egat Li st ener Add the following to the 
ecran ofthat class 


utuncri out 





inerti 
UPoi ne Li ghtComponent® Pol atti ght 





4. Inthe clas implementation, add this to the constructor: 
IMP 
Crest eterna t ubot] eet <uPeiatLi ght Component 
AaatCemponent = Poi atti gh 
Pointcight-9setvi sii ity al sel 





stie 
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5. Inthedel egatelistener. cpp He addsi nci ude "UESCookbont GameNode. h 
between your project's nci ude leandthede! egat eLi st ener header include. 
Inside he Del egat eLi stener: : Begi nPI ay implementation, add the following. 
Super: tegi Pi yl 
He (Teewerid 1e mel ptr) 

Acameliage® Garetode = 

UGameplaySt ates: Get GameWode| Theor! d 

AUEACDoK book Game ode * Hy Game ode 

Cast clé tCos bos taceo dt^ Gora d) 

if (nyGarenage 1e eal per) 

1 
Mytame Mode- ot St andar el gate. binds ect (2h 
Uhber egateListenersEesblevishti 

E 


6. Lastly implement nati eLi ght 
veld Abel egateListeners: eabl etight|) 


t 
Pol atki ght-9Set isi Bi Ii tyl trae): 
i 


T. Put the following code in our TiggerVolume's Noti FyAct or Begi nOver lap 
uncton 
Uri etel 
iP (Perl 
( 
Acamevode® Ganetiose 
UGaaepl syst atl cs: Ge GameWode| TheWorl d): 
M£iContbonkGaneYode "Hy Game ode 
Cast ciUetCaat bos t aseo ee» Ga rao gs) 
Wüsrelée: jt andar Delegate. Execute Bound!) 
7 











Gert) 
supr) 








3. Besuretoaddi aci ude *UEECookbuok Gane Node. A" to your CPP Ble too sothat 
the compiler knows about the class before we use it 
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3. Compile your game. Make sure that your game mode is setin the current level (eer 
to the ncantting an Actor using SpawnActor recipe in Chapter &, Actors and 
Components if you dont know how), and drag a copy of your TiggeNolume out into 
he level Also, drag a copyofDelegat eli st ener out into the level, and place it 
about 100 units above a pat surface: 





10. When you hit Play, and walk into the area covered by the Tigger volume, you should 
seethe Pei nt Li ght component, which we added to al egateLi st ener, tum on: 


acct 








1. Inside our Game Made header, we decre a type of delegate that doesnt take any 
parameters, called FTr i gger it Signature 

2 We then create an instance of the delegate as a member of our Ga me Wo de class. 

3. WeaddaPoi stLi ght component inside Del egateLi stener so thatwe havea 
visual representation of the delegate being execute, 

4. Inthe constructor, we initialize our Poi nt Li ght, then disable it. 

5. We override Begi nPI ay- We rst call the parent class's implementation of 
Begi nPI ay (1. Then we get the game wortd, retrieving the Ga meo e class using 
Get Game Nadel | 

6. Casting the resulting AGame Jose" to a pointer of our GameWode class requires the. 
use ofthe Cast template function. 

7. We can then acess the delegate instance member of the Ga seHede, and bind 
ourēnabi eLi ght function o the delegate, so it wil be called when the delegate 
is esecuted. 

B. In this case, we are binding to UF UNCTI ON() so we use Bi ndUObj ect If we wanted 
to bind to a plain Ce class function, we would have used Bi tv. If we want to 
bind to a statie function, we wil use Bi ndst at i cl] 

9. When Ti gger Val ume overlaps the player, it retrieves Ga se oe, then calls 
Executel 1 Bound on the delegate: 

10. Execute found checks that there's a function bound to the delegate, and then 
invokes it for us. 

11. The£nabl eLi ght function enables the Pai nt Li ght component when inoked by 
the delegate object. 


See also 


= The next section, Unregistering a delegate, shows you how to safely unregister your 
delegate binding in the event of the Li stener Being destroyed before the delegate 
is caled 














Unregisterin 





Sometimes, itis necessaryto remove a delegate binding. This like setting a function pointer 
tonu! ptr so that itno longer references an object that has been deleted. 


Getting ready 


‘oul need to follow the previous recipe in order for you to have a delegate to unregister. 
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How to do it. 


1. InDel egat eLi st ener add the following overridden function declaration: 


vrincriont 
dije rait tnansay const End ayhesson Type 





2. Implement the function like this: 
void Abel egateListener:: EndPl ay| const EEndPI ayeason:: Type 
t 
Super: EndPl aj EndPl ayRenson] 
M (Themerl gt nul pte) 
1 





UGamepiaystati cs: Get GaneNadel Ther d) 
AUEACookbookGaneNode * WyGaneNode 
Cast <AUEACookasokGane Mode» Game Model 
if (i Ganevage = nul ptr) 
[ 

Wüsrelode- St andar dbe egat e. Usb ndl 
, 





D 
j] 


1. This recipe combines both af the previous recipes in this chapter so far. We verde 
Ena PI ay, which is an event implemented as a vital function, so that we can 
emcute code when ourDel egat eL i stener leaves play. 

2. In that overridden implementation, we callthe nbi né|) method on the delegate, 
Which uniinks the member function fm the Del egateLi stener instance: 

3. Without this being done, the delegate dangles Ike a pointer, leaving it in an invalid 
state when the Del eat eList ener leaves the game, 





So far, the delegates that we've used haven't taken any input parameters. This recipe shows 
ou how to change the signature of the delegate so that R accepts some input 


e 








Getting ready 


Be sure youve followed the recipe at the beginning ofthis chapter, which shows you how 
tocestea Trigger Vol ume and the other infrastructure that we require for this recipe 


How to do it. 


1 


éd à new delegate declaration to Gaeo de. 


DECLARE DELEGATE OneParami FParanDel egatesi gratare, 
Linear or) 


da nen member to Game Nede: 
Fhirsebel egatesi goaturehyParansterael esate 


Create anew Act or class called Par anel egat eLi st ener. Add the following to 
the declaration: 

veuncri ont 

vaid SetLi ght Color] FLI near Col orti ght Car) 

inerti 

UPoi nt Light Component* Pol at Light 


Inthe class implementation, add this to the constructor: 
Pintian = 

Crest ebef au bob) ect <uPolatLight Component >(* Pai nt LI ght") 
aot Cemponent = Pol atti gh 


Inthe par anvelegateLi stener. cop He add#i nel ude 
“UEtCookbockGaneWade. h" between your projects i ncl ude Heard the 
ParanDel egat Listener header include. Inside the Par andel egat eL stener: 
Begi nPI ay implementation, dd the following: 
Super: Begi nPl ayt] 
Werl Thedarig = Get wor dl) 
iE Eher d t= nelipte) 
t 
Acamelage! Garetode = 
UGanepl syst atl es: Ge GameWode| Thethri d): 
AUEACooK book Game ode "Nyame ode 
Cast cé tCos bos acea de^ Gamela de). 
if (WyGarenage 1e naligirl 
' 
Ny GameWode- Ny Parameter Del egate. Bi adU0s) ect thi s 
‘dparanelegat ell stener::SetLi ght Color] 
2 
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6. Lastly implement set Light ol or. 
val AParanbel egat eli stener:: SetLi ght Color 
(ELinesresl aright cal er 
t 

Pai atLight->Set Li ght Col or] Li ght Cot or] 
i 


T, Inside ourTti oger Vol ume, noti yAct ar Begi nOver I ap, add the foloning line 
afier te caltoby St andar dDel egat e. Executel t Bouni 
Ny Gamevode 
Sigparanet erQel egate.Executel ovn Li nearColer(1, 0. 0 
in 


1. Our new delegate signature uses a sii diferent macro or declaration. Note he. 
| Dre? am suat the end f DECLARE. DELEGATE OnePar am. AS you'd expect 
‘ne aso need to specify what e our parameter il Be. 

2. Just ike when we created a delegate without parameters, we need to create an 
instance of the delegate as a member of our Ga se oe class. 

3. We now create a nen type of Del egat eLi st ener, one thats expecting a parameter 
to be passed into the function that binds t the delegate. 

4. WhenmecaltheErecutel found) method for the delegate, we now need 
to pass in the value that wil be inserted into the function parameter, 

5. Inside the function that we have bound, we use the parameter to set the color 
ofour ight. 

6, This means that Tri ger Vol ume doesnt need to know anything about the 
ParambelegsteListener inorder to call functions on t. The delegate has 
allowed us to minimize coupling between the two classes. 


See also 


= The Unregistering a delegate recipe shows you how to safely unregister your delegate 
binding inthe event of the Listener being destroyed before the delegate s called 





d data with binding 





ith only minimal changes, parameters can be passed through to a delegate at creation time. 
This recipe shows you how to specify data to be always passed as parameters to a delegate 
invocation: The data is calculated when the binding is created, and doesnt change from that 
point forward. 


ac 








Getting ready 


Be sure youve followed the previous recipe. We wil be extending the functionality of the 
previous recipe t pass additional creation time parameters to our bound delegate function. 


How to do it... 


1. Inside your APara me! egateLi st ener: : Begi nPI ay function, change the call to 
indus] ect to the following: 


Ny GameNode- Ny Parameter Delegate. Bi nduObj ect this 
Gharanbel eget eli stener: Sef ght Cater. fai): 


2, Change the declaration afset Li ght Col er to this: 


yel SetLightCol or|FLinearCol arLi gatCal er, bool 
ERIT 


3. Ater the implementation of Set Li ght o! or as follows: 


void AParanbel egat eli st ener: SetLi ght Color 
(FLinearestorti ght Col er, bool fnabieli ght) 


Pai atLight->SetLi ght Col or] Li ght Color) 
Poi atli ght- >Set Visi lity] Enabl eLi ght) 
, 


4. Compile and run your project Verify that when you walk into Trigger vol ume, the 
ligt tums off because of the false payload parameter passed in when you bound 
the function. 


1. When we bind the function t the delegate, we specify some addtional data (in 
"bis case, a Boolean of value f a! se) You can pass up o four payload variables in 
this fashion. They are applied to your function after any parameters declared in the 
DECLARE, DELEGATE," macro that you used. 

2. We change the function signature of our delegate so that it can accept the etra 
argument. 

3. Inside the function, we use the extra argument to tum the light on ar off depending 
on the value being true or false at compie time. 

4. We dont need to change the calito Execut el Bound -the delegate system 
automaticaly applies the delegate parameters, passed in through Erec ut e| f Bound. 
[ESE Kthen appes any payan parameters hich are aan spece aner be 

jncion reference In a callto 3i sdiDsj ect 
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See also 


= The recipe Unregistering a delegate shows you how to sfelyunregister our delegate 
binding in the event of the Listener being destroyed before the delegates called 


ngam 





The standard delegates used so far in this chapter are essentially a function pointer-they 
allow you to call ane particular function on one particular object instance. Multicast delegates 
are a collection of function pointers, each potentially on different objects, that wil ali be 
invoked when the delegate is broadcast. 


Getting ready 


This recipe assumes you have followed the initial recipe in the chapter, as it shows you how to 
create Tr i aget Vol ume that used to broadcast the multicast delegate. 


How to do it... 


1. Adda new delegate declaration to the GaneNode header: 
DECLARE MULTI CAST, DELEGATEI Nul ti cast el egat esi gnat ure) 





2. Create a new Act or class called Yul ti cast Del egat eLi stener Add the folowing 
ta the declaration: 














utuncri owt 
vaid Toggi ig C 
ener! OMI | 
virtual vold EndPiaylconstEEndPlayReason: Type. EndPlayeasoni 
vuroreny|| 
UPoi mt LightComponent Pol atti ght 
Fel egateNandl eNjDel egat eani e: 
3. Inthe clas implementation, add this to the constructor: 
Point gh 
rest eter suit subebj eet <uPeiatLi ght Component “Pol at Li ght 
aot Component = Pol atti gh 
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4. Intent ti cast Del egat eLi st ener. cop Be, addi nci ude 
"UE Costo Ga need, ^* between your projects i nc ude Heard the 
ul ticast Del eqateti tener header include. Inside the Wel ti cast Del egat el 
i stener: : Begi nP ay implementation, add the flowing: 
Super: :egi Pt ayt) 
Umrla Thevorid = Geer‘ dl) 
i Cheer d te nelipte) 
t 
Acaneliage! Garetode = 
UGaaepl syst atl cs: Ge GameWode] Theor d): 
M£iContbonkGaneYode "Ny Game ode 
Cast <iUetCoatbeat amend Gamela de). 
if (nyGareniage 1e nal per) 
i 
Miel egateansie = my Gamesegs 
P» ti castDelegate. AéjUDSJ ect this 
Ennis ceete eget sti stener! Tago eli gat) 
E 


5. ImplementTogaleLi ght 
void Multi cast Del egat el stener:: Tegal eLi ght() 


( 
Poi atki għt->Toggl e siti ty 
' 


6. Implementournslay overridden function: 
void Multi cast Det egit ei tener: EndPlay 
Tisnstténéblaphessar. Type Enirlaptessen 


( 








Super: EndPl aj (EndPlayRenson] 
Mele Thewerlé = Geter di] 
I (theweri¢ Le nal pte] 
1 
Acaneode® canevase 
Ucamepiaystat es Get GaneNade(Thellar d] 
JüttCaskt ink amete * MyGaneNade 
Cast chétCosk tos Gane ode» Game Model 
Y(t Gamevoge = nul ptr) 
t 
Mya nenage. 
SAYIT ET cast Del agate. Remove( y De! egat ekandi el 
i 
D 
, 
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7. Add the folowing ine tTri gger Vol une: :NotifyAct or Begi adver lapi 
Ny Gamevode->€y ul ti cast Delegate. Broadcast C) 





8. Compile and load your project. Set the Ga meio de in your level to be our cookbook 
garre mode, then crag four or pe instances of lel ti cast Del egat eti stener 
lo the scene. 

9, StepintoTri quer Vol ume to see allthe Mul ti cast Del egateLi stener toggle 
their ights sity. 


1. As you might expect, the delegate type needs to be explicitly declared as a multicast 
delegate rather than a standard single-binding one. 

2. OurnewListener class is verysimilar to our original e! egateLi st ener The 
primary difference i that we need to store a reference to our delegate instance in 
FDelegatekandi e. 

3. When the actor is destroyed, we safely remove ourselves from the list of functions 
bound to the delegate byusing the stored F Del egat eHandi e as a parameter 
toherovel) 

4. Thear oadcast |) function is the multcastequialentof Exec ut elf Bound! | 
Unike standard delegates, there is no need to check If the delegate is bound either in 
advance or with acal lie Executel f Bound. 8readcast t) is safe to run no matter 
how many functions are bound, or even if none are. 

5. When we have multiple instances of our multicast listener in the scene, theyeach 
register themseives with the multicast delegate implemented in the Ga meNode 

6. Then, when theTr i gger Vol uze overlaps a player, it broadcasts the delegate, 
and each Listener is naped causing them to tog the vst of their associated 
point ight- 








T. Multicast delegates can take parameters in eractiy the same way that a standard 
delegate can. 


stom Ev 





Custom delegates are quite useful, but one of thelr imitations is that they can be broadcast 
eternally by Some ather thidpart cass, that is, their Execute Broadcast methods are 
publically accessible. 


‘times, you may want a delegate that is externally assignable by other classes, but can only 
be broadcast bythe class which contains them. This is the primary purpose of Events. 








Getting ready 


Make sure you've followed the tal recipe in this chapter so that you have the 
Trigger Vol sme and Coot ont Gere ode implementations. 


How to do it. 


1. Add the folowing event declaration macro to the header of our Tri gger Vol une 
dass 


DECLARE, EVENT ANJ TEL gger Volume, FPlayerEntered) 
2. Add an instance of the declared event signature to the class: 
FPlayerënteres0nPi ayer Entered: 


3. IMAMY Trigger Vol ume: Net if yAct or Begi Over! ap, add this: 
oePlayerteterei. Broadcast 





Create anew Act or class, called Tri gger Vol Event Li stener 
‘Ad the following dass members to its declaration: 


nm 
UPai nt LightComponent® Pol at Light 


UHROPERTH Edi Any mere 
AuyTriggerVal ame” Tri ggerventSeurce 
veunert out 

vaid OntriggerEvest() 


6. Initialize Poi nt Li ght in the class constructor: 


oiattight = 
CreatepefaultSubobj ect <uPelatLi ght Component >(* Pai nt Li ght") 
aot Component = Poi atti gh 





T. Inside Begi a ay, add the folowing 
i (TelggerventSource t= null ptr) 


( 
Tei aper Event Source- 90001 ayer Entered. dütbj ect (this 
Care oger uol vest Listener. sorte gger vent] 

ł 


3. Lastly implement onTri ggerEvent (1 
veld Ar gerVol Event Listeners: OnTelggerEvent() 


t 
Pai atki għt->Set Li ght Col or] Fli near€ol orto, d, 0, 11) 
1 
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3. Compile your project, and launch the editor. Crete a level with the game 
made set to our UEa Cook boak Gemetide, then drag an instance of 
ATriggerVal event Li stener and ANyTti gge Vel ume out nto the level. 

10. Select Trigger Vol Event Listener and youll seer: gger Vol Event Li stener 
listed as a category in the Details panel, with the property Tigger Event Source: 





11. Use the drop-down menu to select your instance of Aliy Tr i ggerVel une so thatthe 
Látener knows which event to bind t 





12. Play your game, and enter the tigger olume's zone of effect, Verity that the calar at 
our Event Li stener changes to green. 


1. Ae with ali the other types of delegates, Events require thelr on special macro 
functon. 


2. The þrst parameter is the dacs that the event wil be implemented into, Thie wil be 
the oniy class able ta call Broadcast [so make sure it is the right one. 











i 
2 


Cr 
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The second parameter is the type name for our new event function signature. 


We add an instance of this type to our class, Unreal documentation suggests On c» 
as a naming convention. 


When something overlaps our Tr i gger Vol une, we call broadcast on our own event 
instance. 


Inside the new class, we create a point light as a visual representation of the event 
being triggered. 


We also create a pointer toTr i gger Vol ume to listen to events from. We mark the 
UPROPERTY as Edi + Any here, because this allows us to set itin the Edhor rather 
than having to acquire the reference programmatically using Get Al I Actor s0f Class 
or something else. 


Lastis our event handler for when something enters the Tri gger Val ume 
We create and initialize our point light in the constructor as usual- 


When the game starts, the Listener checks that our Tr i gger Val ume reference is 
vali, then binds our OnT i gger Event function to the Tri gger Val ume event 


Inside OnTr i gger Event ,we change our lights color to green. 





When something enters Tri ger Vol ume it causes Tri gger Val ume to cal 
broadcast on its oun event ur Trigger Val Event Li st ener then has its 
bound method invoked, changing our ight’ color. 





ng a Time of Day handler 





This recipe shows you how to use the concepts introduced in the previous recipes to create an 
actor that informs other actors ofthe passage of time within your game. 


How to do it... 


1 


Create anew Actor dass called Ti set! DayHandl er 
éd a multicast delegate declaration to the header 


DECLARE NULTI CAST, DELEGATE TenParams [FORTI meChangedsi gaat 





‘ddan instance of our delegate to the class declaration: 
FONTI mechangedsi geaturetnTi nechanged: 
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Add the following properties to the class: 


ünortrm 
iex Timescale 


rove) 
iei tours 
norem 
inti Rester 


rove) 
fint Elapsedseconds 


‘hd the initialization of these properties to the constructor: 
Timescale = 69 

Hours = 0: 

Minutes = 0 

Elapsedseconds = 0: 


Inside Tick, add the folloning code: 
ElapsedSeconds += |DeltaTi re * Timescale) 
it Hel apsedseconts» 60l 
į 

Elapsedseconds -= t: 

Waatesss: 

i Di nates > dt] 

1 

re 
D 





Onti mechanges. 
i 

Create anew Act or class called CI oct. 

‘ad the following properties to the class header: 
uroen 

UsceneConponest* AootScenetonpanen 





sadcasti Nours, Minutes): 





vurorenty|| 
stati cMeshtomponent* Clociface 
inerti 

Uscenecanponeet® HourHnd!e 
incre 
UstaticMeshComponent* Hour Hand 








urone 
UScenetomponent* Minutekandi e: 
uno 

Usati cMeshComponent* W nutekand; 


utuncri om 
vaid Timechanged(int32 Hours, int32 Mates 
FDelegateNandi eNydel egatehandl e 


Initialize and transform the components in the constructor: 


faotSeeneConponent = CresteDe sl tSubobj ect <USceneConpenent >l" Root 
Scenetonponen 





Crestebet ul tSubobj ect stati cMeshConpenent>l" CI ockFace"} 
pe 
Crestebetaul tSubobj ect stat cest Component >l" nura] 
Crestebef suit subebj eet cust tl caeshcompenent [Mi nutekand") 
HourHanal e = 
Crestebet ult ubebj ect Uscenecompanent l “Hour Handl e"): 
Ninutedansle 
Cresteber sult ubobj ect <uscenecomposent ‘Mi mutehansle*) 
auto leshasset = 
Construct arte! pares: Fob) ectFl ager estat testo TEXTI "Stati e 
Nash | Engine asl eshapes/ Cyl lager. cyl eder =h) 
IY Dshisset oj ect te nal pte] 
t 

ClacbFace- set rati ish Westasset Object] 

Mour hand- >Set Stati cesh WeshAsset Obj ect] 

Mi neteHand- >Set Stati es Meshasset. Obj ect) 
] 
RstCampeeent = RestSceneconposent 
HourHand-sattachTa| BosrHandl e). 
nit tani: oat ace Toc aut elanadi e) 
Hour Handl e- >AttachTol Root teneCorpenent | 
Mi nutehangi e- >AttachTol Root SceseCompanent). 
Ciockface sit tact Tal RaatSeeneCompazent | 
locke ace- Set el ati veTranst oral FTranst ormi 
Ov "Fvecterita, 0, 0). Fvector(2. 2, 0.1M) 
HaurHand- Set el at veTranet orm Firanst arm Ret ater(0, 8, 
V) Fvecter(a, 0, 25), Fvector(.1, 1.1, 0.5))1 
MU nutedang: sete ati vetranstarm FTransieralFRatater(0, 0, 
Qui'Fvecteria, 0, $0), Feecter(o-t, Oi, DII) 














foratori0, 0 
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10. Add the folowing to šegi nP ay: 

TArrayehActor "oTi me yhendl ers: 
Waaneslsystati cr. Get all AetorsOtCl ass Gt orl dl | 
ATimedt ay angler: Statle¢late| |, Timed ay Hensler] 
1t Ti met payané ers. Muni] = 0 
{í 

ute Ti meot tay and er 

Cast «ATi meot BayHondier>| me Day ane! ers] 0] 


Wüslegstehantle = Ti mf Daysand! er 
DoaTlnachanged.AGGUOD] ect] ERL S, Clock: Ti methaeged] 


, 


11. Lastly implement Ti Changed as your event handler. 
old AC eck: Tlmechanged(/nt32 ours, Inta? Mates 











t 
our Mandl esset hel ati veotati onl FRotator| 0, at + 
Wratehandl e-odethel atl veRotati oal FRetater(0.0,6 * 
Wastest! 

i 


12. Placean instanceof Ti me Of Day andl er andthe AC ack into your level, and play 
to see that the hands on the clock are rotating: 
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1. Ti me0t DayHandl er contains a delegate which takes two parameters, hence the 
use ofthe TwoPar ans variant of the mac. 

2. Our class contains variables to store hours, minutes, and seconds, and the 
Ti mestal e, which is an acceleration factor used to speed up ume for testing 
purposes. 

3. Inside the handlers Ti ck function, we accumulate elapsed seconds based 
‘on the time elapsed since the last fame. 


4. We check ifthe elapsed seconds have gone over 60. If so, we subtract 60, 
and increment Mi nut es 





5. Likewise with Mi nut es if they go over 60, we subtract 60, and increment 
Hors 


6. INi nates andHours were updated, we broadcast our delegate to letany object 
"bat has subscribed to the delegate know that the time has changed 

T, Thec ock actor uses a seres of Scene components and Static meshes to 
buld a mesh hierarchy that resembles a clock face. 

B. In thec ock constructor, we parent the components in the hierarchy, and 
Sat thelr initia scale and rotatore. 

9. InBegi ePi ay, the cock uses Get Al I Actors OFCI ass) tn fetch all the 
time of day handlers inthe level. 

10. if there's at least one Ti net! Day Handl er in the level, the CI ock accesses the rst 
one, and subscribes to ts Ti ne Changed event, 

11 When theTi ne Changed event pres, the dock rotates the hour and minute hands 
based on how many hours and minutes the time currentiyhas. 


Creating a respawning pickup for an Firs 


Person Shooter 





Tris recipe shows you how to create a placeabl pickup that will respawn after a certain 
amount of time, sutabe as an ammo er ather pickup for an FPS. 


How to do it. 


1. Create new Act or class called Pi ckup 
2. Declare the folowing delegate pein Pi ckup. h 
DECLARE DELEGATE(#PI ctedupEventSi gaature) 
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3. Add the following properties to the class header: 
virtual void Moti tyActordeginOverl ap(aActar® OcherKter] over 
n 
Stati cMeshComponent* WyMesh 


rove) 
Utotat ingMovement Component Rotati agCamponent 


FPickedupēventSi gosturon?ickesup. 


4. Add the folowing code to the constructor: 
Mesh 
Crest pet aul tSubobj eet <UStati est Component o( Went) 


Aatatingcomonent = 
rest eterni t Subep) ect <URatati aghaveneat Compenent >| "Ratatie 


component") 
Rant Component 
auto Meshasse 
Canstructarkel pares: Fob) ectFi nder <UStat | cNesha[TEXTI "Stati e 
Masi | Engine basi eshapes/ Cube. Cube” ^1) 
1 (Meshasset. ect te nulipti 
t 

WyWesh->Set Stati cesh Nes hasset. Object] 
i 
MyMesh->SetCol Ii sionProfi l eNamel TEXTI* Overl apal I Dynami c*)) 
atati gčanponent->Rotati nate = FRotator(10, 0, 10) 


pest 





5. Implement the overidden eti! yActor Begi stverl ap 


void API chup: oti tyActorBegi adver! ap Mctor* atherActer) 
( 

rbi chedup. Execute bound) 
f 


6. Create a second Act or class called Pi ckupSpawner 


7. Add the folowing to the class header: 


n 
UsceneConponest* Spswlocitien 


vrinciont 
vaid PickapCat Lected( 
UFuner out 

veld Spawehickup( 








x. 


E 


a. 


rope 
Avi chap currentPi chup 
FTI mer Handle Timer 





‘Addi ckup h to the includes in the Pi ckap Spanner implementation he. 
Initialize our root component in the constructor: 


Spauntocat on 
Crenteder sult sued ect <UsceneComposent >| “SpaunLocatien*| 


“Spawn a pickup when gameplay starts with the Spawn cur function in 
Begin ay: 
spaen?ickspl) 


Implement? ckupCo! ected 
vaid API ctupSpeener: Pi chepCal lected) 

t 

Get Worl á| )->Get TI mer Manager (|. Set Ti mer (Mpi mer, tie 
KaPi ckupSpanner:: Spann? chap. 10, false) 

Current? ckup- »0nPi ckedup. Unbind | 

Current Pi cap Destroy] 

' 


(reat the following code forSpaunPi ckup: 
void API ckupSpzuner: SpawsPickupl) 


( 
worlds World = Getiri d0): 
it (Warid t= alisto) 


CarrentPi ckup = Nyiri d-> 
SpeondetoretPickupsi Ai chugs: Stati etl ass) 


GetTransform I| 
CarrestPl ckup- ONPI ckedup. Bi nduonj ect (hi = 
GAPI ctupSpanner: Pi ckapCel ected) 
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13. Compile and launch the editor, then rag an instance ofPictupSpauner outinto 
"Be eve Walk into the pickup represented bythe spinning cube, and vey that it 
‘pawns again 10 seconds later: 





How it works. 


1. Asusual we need to create a delegate inside our P ckup that our Spamer can 
Subscribe to so that nous when the player collects he pickup. 

2. Thei ckup also contains a Statie mesh as a visual representation, and a 
fotatingioverent Component so that the mesh wil spin ina ayto attract 
the attention of he players, 

3. Inside the Pi ckup constructor, we load one of the engines inbuilt meshes 
as our visual representation. 

4. We specify that the mesh wil overlap with other objects, then set the rotation rate 
afour mesh at 10 units per second in the Xand Zanes. 

5. When the player overlaps te? ckap, it pres offis Pi cteus delegate 
fromthe prst step. 

5. Thei ckupSpawner has a Scene component to specify where to spawn the pickup 
actor thas a function for doing so, and a PROPERTY tagged reference to the 
‘urrenty spawned? ckup. 

7. InthePi ctupSpawner constructor, we initialize our components as always. 

3. When play begins, the Spauner runs its Spa wnP i ckup function. 

9. This function spawns an instance of our? i ckup, then binds 


AFi ckupSpamner : -Pi ttupCal lected tothe 0nPi ckedUp function 
fon the new instance. It also stores a reference to that curent instance 





-gm 
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10. When Pi ckupCo! ect ed runs after the player has overlapped the Pi ckup, a timer 
is created to respawn the pickup after 10 seconds. 

11. The existing delegate binding to the collected pickup is removed, then the pickup 
is destroyed. 

12. Ater 10 seconde, thetimer res, rungs pan Act or again, which creates a 
seni chop. 
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Input and Collision 


‘This chapter covers recipes surrounding game control input (keyboard, mouse, and gamepad), 
and collisions with obstacles. 


The folowing recipes wil be covered in this chapter: 





= Ads Mappings - keyboard, mouse, and gan 
character 


pad directional input for an FPS 


= Ads Mappings - normalized input 
^ Action Mappings - onebutton responses for an FPS character 

m Adding his and Action Mappings from C++ 

= Mouse Ul input handling 

= UMG keyboard UI shortcut keys 

= Colisin- ketting objects pas through one another using Ignore 
Colson ~ picking up objects using Overlap 

= Colisin- preventing interpenetration using Block 


Introduction 


Good input controls are extremely important in your game. Providing al f keyboard, mouse, 
and especially gamepad Input is going to make your game much more palatable to users. 











Irgutand Caision 


BRI, You can use bax 360 and PlayStation controllers on your 
Windows PC-tey have USB input, Check your local electronics shops 
AQ] for USB gare contr in order to pr sere ood ones. You can also 

sea wireless controller wit a game controler wireless receiver adapter 
anette to your PC 





Axis Mappings - keyboard, mouse and 
gamepad directional input for an FPS 
character 





There are tuo types of input mapping: Axis mappings and Action mappings. As mappings 
are inputs that you hold down for an extended period of ime to get their effect for example 
holding the W key to move the player forward), while Action mappings are one-off inputs (such 
as pressing the A key on the gamepad to make the player jump In this recipe, well cover 
hom to set up keyboard, mouse, and gamepad axis mapped input controls to mave an 

FPS character 











Getti 





g ready 


You must have a UEA project, which has a main character player in it, and a ground plane to 
walk on, ready for this recipe, 


A. Create a Cer class, Mar ri or, dating tom characte 


Launch UEA, and derive a Blueprint, B? _ War r er, based on your lar ri or class, 
3. Create and select a new Blueprint for your Game ode class as fallos: 
Goto Settings | Project Settings | Maps & Modes, 








vil create a new Blueprint 





[oram 
3. Doubleclick the new? Gare ete Blueprint class that you have created 
to edit it 








Chapter 6 
‘Open yourā? Gane Nede blueprint, and select your Blueprinted 2. arri or clase 
as defaut Pain Class. 


To set up the keyboard's input dring the player, open Settings | Project Settings 
| Input. In the flloning steps, we wili complete the process that drives the player 
fornari in the game: 


1. Click on the +con beside the Axis Mappings heading. 





ais Mappings support continuous ution hel input, wie 
Action Mappings supports one-off events. 


2. Givea name to the Avs mapping. This first example will show how to move 
‘he player forward, so name something Ike Forward. 

3. Undemeath Forward, select a keyboard key to assign to this Ais mapping, 
suchas W. 

4. Click on the +icon beside Forward, and select a game controller input to 
‘map to maving the player Forward such as gamepad Left Thumbstick Up). 


5. Complete Ais Mappings for Back, Lent, and Right wèh keyboard, gamepad, 
and, optionally mouse input bindings for each. 


From your C++ code, ovemide the Set upP I ayer i nput Component function forthe 
Atare ior class as falows: 
valà Marrior:iSetupbi ayer oput Component [UL nputComganeat* aput) 
i 

heck laput) 

Inpat-odindhni s] *Foraré*, this, GAMarrior:: Forward | 
i 


Provide a For ward function inside your Atlar ior class as follows: 


vait ANerelors:Forwarg| float amust ) 
I 
MEC Control ter 46 amunt | 


D 
1) Moves the player forsard by an amust 1s formare 


AsaMovement input (GetActorForwardVector{], amet ) 
1 
i 


ite and complete functions for the rest of the input directions, Atir i ors: Back 
Atare iori: Lett ,andalar rior! Right 
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‘The UES Engine allows vire up input events directly to C++ function calls. The function called 
byan input event are member functions of some class In the preceding example, we routed 
both the pressing af the W key and holding af the gamepad's Let Thumbstick Up to he. 
Atare iar << Formar d Ctt function. The instance to call Allart i or +< Forward on isthe 
instance that routed the controller’ input. That is controlled by the object set as the player's 
lar in theGaneNo de dass, 


See also 


= Instead of entering the For var input ans binding in the UES editor, you can actualy 
Code itin from C++. Well describe this in detall in a later recipe, Adding Ai and 
Acton Mappings from Ci. 





it 





Mappings - normalized inp 





"uve noticed, inputs of 1.0 sight and 1.0 forward wil actually sum to a total of 2.0 units of 
‘peed. This means itis possible to move faster diagonally than Lis to move in purely forward, 
Backward left, or right directions. What we really should do s lamp off any input value that 

results in speed in excess of 1.0 units whe maintaining the direction of input indicated, We 

‘can do this by storing the previous input values, and overriding the. Ti ck!) function. 


Getting ready 


(Open a project, and setup a Character derivative class (let's call ours Wie). 


How to do it. 


1. Override the Aarti or: :SetupPl ayeri aput Component] UI nput Component * 
Input ) function as falows: 
void Mori or: Set upPl ayer put Component Ul nput Component" Input ) 
t 
Inpat->8indanis| Forward", this, GAMarrior:: Forward | 
Inpt->8indAnis| Back", this, deri or: Back | 
Inpat->indAnis| "Right, this, kaarrior:: Right | 
Irpat-oi diri si *Left*, this, GAMàrrior::Lett ) 


i 





copter 


2, Wrte the comesponding: : For war d,: Bec, Right and:: Left functions as 

follows 

veld Alereior:sForware| float amount ) d 
JI te use a s= af the amount added so that 
Ji then the other function modifying -Y 
Hy fittatk(l] affects Lastinput, 1t en 
J| averarite with a 
lastinpat. im amount: 

] 

ald Mrrior:ifack float ament | { 
lastinpet. Y += cement 

7 

Waid anareior::Right( toat amunt | ( 
lastirpat X += amount 

] 

ald Marrior:ilei float ament) { 
lasti npt. X ve amount: 

: 


3. Intheniarrior:: Ti cki ) function, modify the input values after normalizing any 
oversize in the input vector: 
vaid AMrcior::Thek{ float DeltaTime ) { 
Super: “Tieki DeltaTine | 
i Contral er | 
' 
oat en = lastleput. Sisell 
Hp lens LEI 
lastinpat [e Len 
aisheremeeti ntt 
GetdctorFereardvector{|, Lastl aput- Y ) 
AadMovementtnput(GetActorAi ght Vecter(), asti nput. X 
TI ero eff Last input values 
Hastlaput = Fvecter20) 0.15 001 
E 


We normalize the input vector when itis over a magnitude of 1.0. This constricts the 
maximum input velocity to 1:0 units (rather than 2.0 units when full up and full right 
are pressed, for example). 

















Je Action mapping ie for handling sine button pushes (not buttons that are hele down). 
Fer button that should be held down, be sure to use an As mapping stead. 


Getting ready 


Have a UEC project ready with the actions that you need t complete, such as] usp 
orSnaet Gus 


How to do it... 


1. Open Settings | Project Settings | Input 
2. Goto the Action Mappings heading, and click on the con beside It. 


1. Start to type in the actions that should be mapped o button pushes, 
Far example. pe in] uap forthe first Action. 
2. Selecta key to pres for that action to occu, for example, Space Bar. 





3. if you woud ike the same action triggered by another key push, click on 
the +beside your Action Mappings name, and select another key to tigger 
the Action. 


4. If you want that the Shift, Ctrl, Alt, or Cmd keys should be held doun for the 
Action to occur, be sure to indicate that in the checkbones to the right of the 
key selection box 





3. To link your Action to a C++ cade function, you need to override the SetupP a yer! n 
put Conpanest|Ulnput Control" cant al | function. Enter the following code 
inside that uneton: 


vel dhvarrs or: : SetapPl ayeri oput Conpanent | UI aput Corpenent* 
[ 

thectti aput | 

Ji Connect the Junp action te the C64 Jump foret 











Inpat->8inaAction(*Junpe, 18 Pressed, this 
farrier um | 


Action Mappings are singleton push events that fe off C+-cade torn in response to 
‘them You can depne any nurrber of actions that you wish in the UES Editor, but be sure to 
tie up Action Mappings to actual key pushes in C++. 


See also 


‘Yu can list the Actions that you want mapped from C++ code, See the following 
recie on Adding Axis and Acton Mappings from Ci for this 








d Action Mappings from C++ 


Axis Mappings and Action Mappings can be added to your game via the UES Editor, but we 
‘an also add them direct rom C++ code. Since the wireup to C+ functions is fom C++ code. 
“anya, you ray ind it convenient to depne your As and Acton Mappings in Ce as wal 


Getting ready 


‘You need a UES project to which you'd ike to add some Axis and Action mappings. You can 
delete the esting Ads and Action mappings isted in Settings Project Settings | Input if 
Jou are adding them va C++ code. To add your custom as and action mappings, there are 
‘wo Cr functions that you need to know about: the UPI ayer Input :: debui slspp: ng 
andü ayeri apst:: AddActi onMappi ng. These are member functions available onthe 
UP ayer input object The UPI ayer! nput objectis inside the PI ayer Control ler object, 
accessible via the folloning code: 





eter) oet First PI ayer Contrat Lori ob ayeri nput 


‘You can also use the two static member functions of UPI ayer I aput to create your aiis and 
action mappings if you'd prefer not to acces player controllers indiddualiy. 


UP ayeri nput:: AddEngi nedefi sedani sappi ngl 
Vr ayeri nput:: AddEngi neDefi nedact i onMappi naL 














1. To begn with, ve needto debne our spit Axi s KeyMappi ng oF 
fl nput Arti onkeyNappi ng objects, depending on whether you are hooking up an 
Anis key mapping (er buttons that are held down for input ar an Action key mapping 
(far onet events -buttons that are pressed once for inputi. 


1. For Mads key mappings, we define an FI nput Axi s Cey Mappi ng object, 
as flows 


input sKeyMippi ng batkteyl “Baci, EKeysiiS, LE) 
2. This will include the string name for the action, the key to press (use the 


Keys enun), and whether or nat Shift, Cr, AL or cmd (Mac shouid be 
held to tigger the event. 


3. For action key mappings, define! nput Acti onkey Mappi ng, as follows: 


Finputactionkeyhapping Junel") ung", Ekeys::SpaceBar, O. O, 
va 





4. This vill include the string name for the action, the key to press, and whether 
ornat Shift, Ct, Alt, or cmd (Mac) should be held to tage he event. 


2. Inyour player Pawn class Set ug Pl ayer! apat Component function, register your 
avis and action key mappings to the folowing: 
1. The? ayer I apet abject connected toa specifie controller: 


Get ar d) >GetF| rst ayar Control arl) obl ayeri nput 
Shadanlshappingl backkey 1; 1) specific to'a controller 








2. Or, alternatively you could register to the static member functions of the 
UPI ayer I aput abject directly: 


UPiayeri nput: :Addëngi nebef  nedActl onNappi ngl jump ) 


Be sure you're using the correct function or As 
versus Aton mappings! 


3. Register your Action and Ais mappings to C++ functions using C++ code just as 
shown inthe preceding bwo recipes, for example 
epit si edixit Back, this, AAWarriori: Back) 


epit ket lon] um, JE Presses, this, 6aMerrior-:Jume 
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The action and ads mapping registration functions allow yu to set up our input mappings 
fem C++ code direct. The Ct coded input mappings are essentially the same as entering 
the input mappings in the Settings | Project Settings | Input ilo. 





oi 





UI input handling 


When using the Unreal Motion Graphics (UM G} toolkit, you wl rd that mouse everts are 
very easy fo handle. We can register Ci- functions to run after mouse clicks or other pes 
cf interactions with the UMG components. 


Usual event registration wil be via Blueprints; but in this recipe, we will outine how to write 
and wie up C+ functions to UMG events 


Getting ready 


‘Create a UMG camas in your UEA project. From there, wel register event handlers for the- 
Onli cet, OnPressed. and Orhel essc events, 


How to do it... 


1. Ritclck in your Content Browser (or click on Add New), and select User Interface 
| Widget Blueprint, as shown in the following screenshot: This will add an edtable 
widget blueprint to your project. 





2. Doubleciick on your Widget Blueprint to editt- 
3. Add a button to the Interface by dragging i from the palette on the left- 
4. Scroll doun the Details panel for your button urti you prd the Events subsection. 
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5. Click on the icon beside any event that you'd like to handle 





5. Connect the event that appears in Blueprints to anyC++UFUNCTI OR | that has 
"Best vepri nt Cal atl e tagin the macro. For example, in your Ga re Node cass 
derivative, you could include a function such as: 

UFUNCTIOM Sl vepri stat able, Categary = U Funes) 
veld Suttanci ekea] 
[ 











egere, Warsing, TENTI ‘Ul dettes click 





7. Tigger the function call by outing tolt in the Blueprints diagram under the event of 
ur choice. 


3. Construct and display your UI by calling Create Widget, followed by Add to Viewport 
inthe Begin Play function af your Ga me Ho de ar any such main object). 


Your widget Blueprints buttons events can be easily connected to Blueprints events, or C++ 
functions va the preceding method. 


UMG 





Mr 





rd UI shortcut keys 
Every user face needs shortcut keys associated wth o program these into your UMG 


interface, ou can simply wireaup certain key combinations to an Acton mapping: When the 
Belo triggers, just invoke the same Blueprints function that the UI button self goes 


Getting ready 


You should have a UMG interface created already, as shown in the previous recipe. 
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How to do it... 


1. in Settings | Project Settings | Input, depne anew Action mapping for your hat key 
event, for example, Hot Key Ul Bat ton, Spell 


2. Wire up the event to your Us function call either in Blueprints or in C++ code. 


Wiring up an Action Mapping with a short circuit to the function called by the UI wil alow you 
to implement ht keys in your game program nicely. 





Colision settings are fat easyto get hold of. There are three classes af intersection for 
olisions 


| gnor e: Collisions that pass through eachother without anynotipcation. 
Over! ap: Collisions that trigger the Gnesi adver! ap and Onénddver! ap events 
interpenetration of objects with an Overlap setting is allowed. 


‘Block: Colisons that prevent all iteenetration, and prevent objects from 
overlapping each other at all 


Objects are classed into one of many Object Type. The Collision settings for a particular 
Blueprints Component alow you to class the object as an Object Type f your choice as well 
as to specify how that object colides with all other objects of all ather types. This lakes a 
tabular format in the Details | Collision section of the Blueprint Editor. 
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For example the folowing screenshot shows the Collision settings for a characters 


Capsul ete 








Getting ready 


‘You should have a UEA project with some objects that you'd Ike to program intersections for. 


How to do it... 


1 


‘Open the Blueprint ecitar for the abject that you'd ie other objects to simply pass 
‘through and ignore. Under the Components isting, select the component that you'd 
ike to program settings for. 

With your component selected, see your Details tab (usually on the right). Under 
Collision Presets, select either the NoCollision or Custom.. presets. 


1. If you select the NoCollision preset, you can just leave it at that, and al! 
calisions wili be ignored. 
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2. W you select the Custom... prese, then choose either af the following: 
1. NoCollision under the Colision Enabled drop-down menu. 


2. Selecta colision mode under Collision Enabled involving Queries, and 
be sure to check the [gnare checkbox tor each Object Type that you'd 
We ito ignore collisions wth 


Ignore colision wl ot [re anyevents or prevent irterpenetrations between objects marked 
ach 








ng Overlap 





Collision 6 





cking up objec 





tem pickup is a pretty important thing to get down cleanly. In this recipe, wel utine howto 
etiem pickups working using Overlap events on Actor Component primitives. 


Getting ready 


The previous recipe, Colisons: Letting Objects pass through each other using ignore, 
descries the basics of colisions, You should read ifor background before begining this 
recipe. What wel do here is create a New Object Channel. to identify! tem class objects so 
thatthe can be programmed for overlaps only with te player avatars colision volume, 


How to doit... 


1. ‘Start by creating a unique colision Channel for the! tem object's colin primitive 
Under Project Settings | Collision, create a nen Object Channel by going to New 
Object Chanel 
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2. Name the new Object Camel ast e 


3. Take your) tem actor and select the primitive component on that used to 
intersect for pickup with the player avatar. Make the Object Type of that primitive 
ani tes dass Object Type 

4. Check the Overlap checkbox against the P san css Object Type as shown in the 
folowing screenshot: 





Take the player actor who wil pick up the items, and select the component on him 
that feels for the items, Usually this wil be is asl eCompone nt «Check Overlap 
vith the! ten object 





7. Now the Player overlaps the iem, and the item overlaps the player pawn. We do have 
to signal overlaps it both ways tem Overlaps Pa wn and Pawn Overlaps |t em for it 
to work properly. Ensure that Generate Overlap Events i also checked for the Pawn 
intersecting component. 
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Next we have to complete the DaCompanent 





gi nüver lap event for either the 


tem or the Player's pickup volume, using ether Blueprints or C++ code. 


1 


8 


1 you prefer Blueprints, in the Events section of the Details pane of 
"he Coins intersectable Component, cc on the +icon beside the On 
‘Component Begin Overlap event 





Use the DeCompusent Begi nOver ap event that appears in your har 
‘Blueprint diagram tà ire in Blueprints code to run when an overlap with the 
Players capsule volume occus 

M you prefer Ces you can write and attach a C++ function to the 
Capsul eCemponent. Wea member function in your players avatar class 
with a signature as folos: 

URINCTI Gh vepri atati vevent, Category = Col ist an 

vel Onoverlapstegini UPriitlveCompenent® Come, AActort 
UPrimtivecomponeat® OrherCom, |nt32 Orherbodyinder, 

heal "bFransucep, const FAleRerul td Sweephesult | 





In UE 413, the OnOveriapsBegin function: signature has changed to: 
Gnverl apedegin( Uri mtr vaCenpasent” Comp, Aketer® 
Gtherhcter,UPrimtl vetomponest® ürnertom | A132 
Gihertodylnden, bool bFrensueep, Const FHIEREsul TE 
Sessiestlt | 


Complete the implementation af the navet! sos Beg! n| function in your 
pp fle, making sure to end the functon name wth | og! eeentati ev. 
veld A¥arrior-:Ongverl apstegin_I nel emeet at on actor 
Ginerdeter, Uerimtivecengatent™ Osher Cong 
(a1) othergeeyl nger 
basi bframbecep, const FH/eResuIt& Sweephesult | 
[ 

ME LOG(LegTeny, Werning, TENTI *Overiaps began" | 
i 





Input and Colison. 








5. Then,provideaPost init iali zeConoonent st} overde to conecte 
raver aps Begi ni| function wth verge to he capsule in sour avatars 
dls as flows 
Vsigee Posti niti ali zeComponests() 

Hla component | 
i 





| Attach contact function to all bounding 
Gertapiul etomponent | 

>oncanposent Begi ver! ap. Addy nami c 
orto: toner apsBeat | 
GetCapsul etomponent | 
Sontompasentérddverl ap. AdgDynamic| thie 
bAmarr iors: Ondverl apséad ) 














‘The Overlap event raised by the engine allows code to run when two UES Actor Components 
overlap, without preventing interpenetration of the objects. 


Collision ration 


sing Block 





Blocking means that the Act or components wil be prevented from interpenetration in the 
engine, and any colision between two primitive shapes vil be resolved, and not overlapping. 
after colision are found. 


Getting ready 


Begin with a UEA project that has some objects with Actors having colision primitives 
attached to them (SphereComponent s ,Capsul eComponent s,orBoxConponent s): 
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How to do it. 


1. Open the Blueprint of an actor that you want to block another actor with. For example, 
we want the Player actor to black other Player actor instances. 

2. Mark primitives inside the actor that you do not want interpenetrating with other 
components as Blocking those components in the Details pane 





When objects Block ane another, they wl not be allowed to interpenetrate. Any interpenetration 
willbe automatically resohie, and the objects wil be pushed off each other. 


There's more. 


You can override the On 
Tris ie distinc fem the 0 





ponent Kit function o run code when two objects it each other. 
ponent Begi nOver Lap event 
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Communication 
between Classes and 
Interfaces 


‘This chapter shows you how to write your own Unterfaces, and demonstrates how to take 
advantage of them within C+ to minimize lass coupling and help keep our code clean, 
The folowing recipes wil be covered in this chapter: 

= Creatinga Ui atert 

Implementing aul st er face onan object 

Checking fa class implements a Ui nterface 
Castingto aU nt ert ace implemented in native code 
Coling native UI at er face functions fom C++ 
Inherting Ul nt er f ace from one another 
OverridingUI nter Tace functions in C++ 
Exposing Ul nt erf ace methods to Blueprint fom a native base class 
Implementing UI nter t ace functions in Blueprint 


Creating Ces ster ace function implementations that can be overidden 
in Blueprint 


= Calig Blueprint deped interface functions from C++ 
Implementing a simple interaction system with Unterfaces 
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Communication between Clases and interfaces — 


Introduction 


In your game projects, you will sometimes require a seres of potentially disparate objects to 
share a common functionality, but it would be inappropriate to use inheritance, because there 
is no "isa" relationship between the different objects in question. Languages such as C++ 
tend to use multiple inhertance to sohe this issue. 


However, in Unreal, ¥ you wanted functions from both the parent classes to be accessible to 
Blueprint, you would need to make both af them UCL ASS. This i a problem for two reasons, 
Inheriting irom UCI ass twice in the same object would break the concept thatuDs] ec 
should form a neatly raversable hierarchy. It also means that there are two instances of the 
UCI ass methods on the object, and they would hae to be explicitly differentiated between 
within the code, The Unreal codebase sales this issue by borrowing a concept from C8- hat 
ofan explicit interface pe. 


The reason for using this approach, instead of composition, is that Components are only 
available on Actors, not on UObjects in general. interfaces can be applied to any UOB] e 
Furthermore t means that we are no longer modeling an ‘s-a relationship between the 
object and the component; instead, it would oniy be able to represent has." relationships. 


Creating a UInterface 


Unterfaces are a pair of classes that work together to enable classes to exhibit polymorphic 
behavior among multiple class hierarchies, This recipe shows you the basie steps invlved in 
creating aU nter tace purely in code, 


How to do it. 


1. Untertaces dont show up inside the main class wizard within Unreal, so wel need to 
add the class manually using Visual Studio. 


2. Right cick on your Source folder inside Solution Explorer, and select Add | New 
nem. 


Selecta. h Heto start, and nameitiyi nterface. h 


Make sure you change the directory for the item to be placed in from Intermediate to 
Source Projectiame. 


5. Glick on OK to create a newheader He in your project folder 
6. Repeat the steps in order to create | nt er tace. cpp as your implementation He. 
7. Add the following code to the header He: 


ontarac 














class UEACOOKBOOK, APL UNy!ntert aces p 
( 

sENERATED, soov) 
I 





c ulntertace 





(late UEACOOKEOOK,API LN atert ace 
į 
SENERATED, Booy) 


public 
virtual Hit ri neget Test Namel ): 
I 

3. Implement the dass with this code in the. cpp He: 
nel ade *UEdCookbook. h" 
finci ade “Wl rterface h" 


Estri ng Iyi nterface: Get Test Nane) 
t 

ani spl emented() 

return Pétri nal 

] 


9. Compile your project to verify that the code was written without errors. 


1. interfaces are implemented as a pair of classes declared in the interface's header. 


2. Ae always, because we are leveraging Ureal's ejection system we need to include 
‘ur generated header Be. Refer to Handing events implemented via virtual functions. 
în Chapter 5, Handling Events and Delegates, for mare information. 


3. Ae vith classes that inherit from UObj ect , which uses UCLASS, we need to use the 
UINTERFACE macroto declare our mew et erf ace 


4. The class is tagged UEA COOKBOOK, API to help with the exporting of vary symbols 
5. The base class forthe Ij ect portion of the interlace is UI nter face. 


6. Just ike UCLASS types, we require a macro to be placed inside the body of our class 
So that the auto-generated code s inserted into it 


T. That macro is GENERATED, 80D) for Unterfaces. The macro must be placed at the 
very start of the class bod 


B. The second class is also tagged VESCOOKEOOK, 4 , andis named in a specibe way 
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9, Note thatthe U at erf ace derived class and the standard class have the same 
name buta different prepa Thel «t erf sce derived dass has the prepa, and the 
“Standard dass as the prepac! 

10. This is important as this is how the Unreal Header Tool expects the classes to be 
named for the code it generates to work property. 

11. The plain native Interface class requires its own autogenerated content, which we 
include using the GENERATED, BODY} macro. 

12. We declare functions that classes inheriting the interface should implement inside 
Minter ace 

13. Wihin the implementation e. we erplement the constructor for our nt er ace. 
as tis declared bythe Unreal Header Tool, and requires an implementation. 

14. We also create a defaut implementation for our Get Test Na re (| function. Without 
this, the linking phase of complaton wil fail. This default implementation uses the 
uni nel ementeat} macro, which wil issue a debug assert when the line of code i 
recited 


See also 


= Refer to Passing payload data with a delegate binding in Chapter 5, Handling Events 
and Delegates; the prst recipe, in particuiar, plains Some ofthe principles that 
weve applied here 





ementi n object 





Ensure that youve followed the previous recipe in order to havea UI nt er tace readyto be 
implemented. 


How to do it... 


1. Create anew ct or class usingthe Unreal Wizard, called 
Singiel nterfacekcto 

2. Addi Enter ace-inthis case, I NyI nt er face -to the pubiic inhertance list for our 
new Act or dass 


lass UEACOOKBOOKLAPI ASi aplel tert aceActor : publi 
Matter publie Interact 





3. Aid an override declaration to the clas forthe! nt er face function(s) that we 
mish to override: 


Fstriagger Test Namel) override: 








acc 





Chapter? 
Inplementthe overien function inthe irplemetation le by ading the flowing 
code: 

Fstri ngasi ngl ent erfacehctor: GetTest Hane) 

( 


return D sterface: Get Test Manel 
i 


1 


Cet uses multiple inheritance forte way it implements interfaces, so we leverage 
"Bat mechanism here with the declaration af our S1 ngl e! er! acelctor elass, 
where we add public | Winter face 

We inher from! | nt ert ace rather than Ul nt er face to prevent 
Singlelnterfacekct ar rom inheriting two copes of Ub ect 

Given that the interface declares a vi tual function, we need to redeclare that 
function with the override speciper f we wish to implement it ourselves. 


Inourinplemertation He, we implement our veriden vi rt va! function. 


inside our function override, for demonstration purposes, we call the base 
1 inter t ace implementation of the function, Atematively, we could write our own 
implementation, and avoid calling the base class one altogether. 
Weuseiinterface:: specifier ratherthan Super , because Super refers to 
the UCI 22s thats the parent of our class, and Interfaces arent UClsses hence, 
noU pre. 


‘You can implementa second, ar multiple, interfaces on your object, as needed. 





cking if a impl 


Folio the frst two recipes sothat ouhave a UI nt er f ace we can check for, and a class 
implementing the interface, which can be tested against 


How to doit... 


1 


Inside your Game Mode implementation, add the follwing code to the Begi «bl ay 
function 
FTranstorapannLocatl on: 


ASingielnterfacekctor* SpamnedActar = Get Weri dll 
DSpawedet er ASinglel ster‘ acetetor> 


(Astnglel stertacedctor: Stati ecles|), Spawnbecstl en 
1f (Sprenedhetor stet Class] 
Dinpl emestsl ster ace INT nterface: tati cClass1))) 











m 


Communication between Clases and interfaces 


( 
engl ne- hdatrScreesbebaplessage|-1, 1, Fol er: Red 
TeAT|"Spenned actor implements ister‘ ace!) 


$ 


2. Given that we are referencing both ASi ngl el nterfaceActor andi Nyl nterface, 
weneedto i nci ude both Nyi nterface. à andSisgl el nterfacedctor. hin 
our Source He. 


1. Inside Segi s! ay, we create an emptyF Tr a nst or m function, which has the default 
value of 0 for ali translation and rotation components, so we don't need to explicitiy 
setanyof them. 

2. We then use theSpaunact or function from ier d so that we can create an 
instance of our Si ngl sAct or | at erf ace, storing the pointer to the instance ino a 
temporary variabile. 

3. Wethen use et CI ass(] on our instance to geta reference to s associated 
UC ses We need a reference to Uc s. because that object i the one which 
holds ali af the rejection data forthe object. 

^ Rejection data includes the names and types of all UPROFERTY on the object, the 
inhertance hierarchy far the abject, and a ist af al the interfaces that it implements. 

5. As aresuk, we can calli mpl ements! nt ef ael] onUCI ass, and twill return 
true ifthe object implements the Ui nt er ace in question. 

6. the object implements the interface, and therefore, returns tr ve from 
Impl ementsi nterface, we then print a message o the screen 


See also 


= Chapter 5, Handling Events and Delegates, has a number of recipes relating to the 
spanning of actors 











‘One advantage that Unterfaces provides you with as a developer is the abilty to teat a 
‘collection of heterogeneous objects that implement a common interface as a collection of the 
same object, using Cast « > to handle the conversion. 








Caper 


[ g Please note that this wont work if your class implements ] 


"he interface trough a Blueprint. 


Getting ready 


You sheuld have UI nter ace, andan Actor implementing the interlace ready for 
this recipe. 


‘Create a new game mode using the wizard within Unreal, or optionally reuse a project and 
"reo ge from a previous recipe. 


How to do it... 


1, Open your game mode's declaration, and add anew UPROPERTY(] sacro toit: 
nom 
Tarrayd Myintertaci 








toti ntertaci 


‘dd tincl ude *Mylntert ace. h tothe headers include section. 
‘Ad the following within the game modes tegi nPI ay implementation: 
tor (CTictoriterstorettor» |t Getter! dl) 
Mittari stmt strae i TE atl 

í 

Alert Actor = Hit 

IW ntertace® Mylnterfacelnstance 
cast i ylatert aces) actar) 

Te (nyt atertacei net ance) 

1 

Nyinterfacel natancen. Addl nterfacel nstance) 
r 
] 


"Engl et sHdosScreenbebupiessagel-, 1. Fest or:i Red 
Pétri gi Pr HTERTC ME actora implement the intertace*), 


Wisterracenstances. un 








44 Set the levels game mode override to your game mode, then drag a few instances of 
our custom ntrfaceimplementing actor into the eve, 
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5. When you play your level, a message shoud be printed on screen that indicates 
"he number of instances of the interface that have been implemented in Actors in 
the levei: 





ks. 


1. We create an aray of pointers to Ny! et er sce implementations. 


2 Insdezesi a? ay,weuseTactorl tarator ektcter> togetallof he Act or 
instances in our lave! 


3, Thcter| terator has the following constructor: 


explicit TActoriterater| Ubrli* Lavert a 
Tile ascot chetortypesl Clase = ketartype::Statleclass(| ) 
Superi sterii, inthas | 


4. Tictoriterator expects a wordt actonas well as a UCI ass instance to specify 
What type af Actors we are interested in. 


5. Actoriteratar isan iterator Ike the STL iterator type. This means we can wite a 
far loop of the following form: 


far (iterator- constructor: Iterator: s terator] 


5, Inside the loop, we dereference the Reratarto getan Act or pointer. 


7 We then attempt to cast it to our interface; this wli retum a pointer to the interface if 
does implement t, else wil retum aul lot 

3. Aca result, we can check if the interface pointer is su! |, and if nl, we can add the 
interface pointer reference to our array. 

9. Finally once wee erated through all the actors in TAct ar | tar at or, we can 
dsplaya message on the screen, which displays the count of tems that implemented 
the interface, 














Folio the previous recipe to get an understanding of casting an Act or pointer to an Interface 
pointer. 


Note that as this recipe relies on the casting technique usedi in the 

ag previous recipe. wil only work with abjecs that implement the interface 

A> using C++ rather than Biueprint This is because Blueprint classes are nat 
aisle at compile ti, and sa, lechrical don't inert the Interface, 


How to doit... 


1. Createanenàct or class using the editor wizard. Callitant| Gravi ty¥ol use 
2. AddBoxConpanent to the new Act or 

mm 

Utoxtonponent* Col listontorpanent, 
3. Overide the following Act or virtual functions in the header: 





4. Create an ivplemertation within your source He, as folios: 
[ 
Ira) ttti act Gravity9bj ee = 
Castel GravityQn) ect scarnerator| 
T Varas tab] ect t= aul ptel 





umes: Moti FyActar Begi nover lapl ctor" 








Grave yobj etti sabl etra ty 


Val aunt Gravi typo umes at fyActorEndover ap deter" 
i 

Ira yon) eet* Gravityðbject = 
Gast etras t yb] ect other hear] 

T Varas tob] ect te aul ipte) 
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5. Initialize theBoxComponent in your constructor: 
‘dtl Gravi tyVol ume: : ati Gravi tyVal umel | 
c 
Primer pietati ck. acanévertick = true: 
Coli isi anComponent 
Ereatenetaul (Suse ect cl 
Ical lisi onCompanent *} 








oxconponent > 


Coli isi anComponent->Set BoxExtent | Fvecter(200, 200, 400)); 





Root Component = Col tisi anComsonent: 


' 


6, Create an interface called Gr avi ty0bj ect 
T. Addthe folowingvir tual functions to! Gravi Object 


virtual vaid Enabl eGravity|| 
virtual vaid DisableGravi tyl) 


8. Create the default implementation of the vi r tva! functions inside the 
KGravi t yObj ect implementation He: 
voll GravityObj ect: Enabl eGravity(1 
À 
ket ort Thi shedctor = Cast<Metora[ this) 
i (Thi stsdetar f= ult te) 
1 
Array <UPr imi ti veComponent>Pri mi ti veComposent 
ThisAsActor->GetConponents| Pri mi ti veCamponents] 


far (Uri miti veComponent* Companen 
Prime ivecomponents) 
( 

Comenest->set nab eGravi tyle rue 
1 


D 
' 





val dl Gravityos)ect::Disab eGravity{| 
( 

ket ort Thisäsäctor 
LP (Thi sAsdetar 

' 





Greer 
unti 











ThrraycuPeim t vecompenent9Pri miti vecompasent 
Thishedctor-oGet Conposents( Pri mi ti veCanponent | 
for (Ur mti veCompanent* Corponen 
Primi vecompenents) 
t 

Compenest->set nab trav tyl tal sel 
, 





D 
, 


9, Create a subclass of ctor called Physi es cube 
20. Add a static mesh 


no 
stati cMeshComponent* WyMesh 


11. Initialize the component in your constructor: 
es 
Crest eet aul tSubobj ect cust tl caeshcompenent 1 yesh") 
sutolesnasset 
Construct arte! pers: Fab etfi der elstati esto TENTI "Stati e 
Nes | Engine Basi Shapes) Cube. Cube *)); 
i Distisset Object t= naliptrl 
( 
yesh Set stat emeshlWeshasset. ob ect 
i 
NyMesh- Set Mabi |i ty Component Mobi Lit y: Movable] 
Nyest- >SetSi ml at ePhysi cel truel 
Sethetortesbl etel isl anit rael 





12. Tohave Physics Cube implementór avi ty0b] ect sti nel ude 
* Gravi t yObj ect. inthe header He. then mad the dass declaration: 
lass UEACOOKBOOK_APL APhysicscube : public aactor, public 
Toravityosjec 

13. Compile your project. 

14. Create a new level, and place an instance of our gravity volume in the scene. 
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15. Placean instance of Physi cs Cube above the gravity volume, then rotate lt slightly 
so hat it has one corner lower than the others, as shown in the following mage 


16. Vett the gravity is tumed aff on the object when It enters the volume, then tums 
back on again. 


Note that the gravity volume doesnt need i know ayting about your 
SES piyale Cube acion ast the Gras ecl trace 


1, We create a nen Act or class, and add a box component to give the actor something 
hat wil colide with te character Atermatvel you could subclass ava! use If you 
varied to use the BSP functionality to depne the volume's shape. 

2, NotityActorBeginover| ap and att yActorEndOver I ap are overridden 
‘So that we can perform some operation when an abject enters or leaves the 
Anti Gravi tyVel ume area. 

3. InsideNoti tyActor Beg] nOver! ap implementation, we attempt to cast the object 
that overlapped us into an I Gravity 0o] eet pointer 


4. ‘This tests if the object in question implements the Interface. 


5, Ifthe pointer is valid, then the object does Implement the Interface, so it is safe to 
use the interface pointer to call interface methods on the object 


5. Given that we are inside Neti fyActardegi nüver 1 ap, we want to disable the 
aviy on the object, so we call Di sab! ebravi t 














T InsideNoti tyActorEndOver I ap, we perform the same check, but we reenable 
graviy on the object 





Chapter? 





20. 


E 


n. 


a. 


ED 


as. 


a. 


x. 


ES 


E 


Wein the default implementation of Di sab! eGr avi t y, we cast our oum pointer 
Mhethis pointer) to actor 

This allons us to corprm'hattheirtrface has been implemented anlyan the het or 
“subclasses as wall as to call methods denedin ct oF 

I the pointer is valid, we know we are an Actor „so we can use 

Get Components ecl ass Component Ty pe>|) to geta TAr ray ofall components 
of a specibe type fromoursehes. 

Get Components isat enpi at e function. It expects some template parameters: 
tenplatecclase T, class allecatertype> 


‘val dGetCamponents|TArray<T*, AlI ocatorType>k0ut Components) 


‘Since the 2014 version of the standard, C++ supports comple lime deduction of 
template parameters. This means that we dont need to actually specify the template 
parameters when we call the function if the compiler can work them out from the 
normal function parameters that we provide. 

The defaukt implementation of Array istempl ate<typename T, typename 
Al locatar = #Oet aul tk locator» las TAr ray: 

‘This means that we dont need to specify an allocator by default, so we just use. 
Thr ray<UPri mi tiveConponent "> when we declare the array. 

When Tár ray is passe into the Get Components function, the compiler knows 
itis actualy Tar rayelPri mi tr veCompenent*, FDefaultAl Locator», 

and itis able to pin the template parameters T and à! I ocat or Type with 
UPrimitiveComponent and Det aul All ocat or, so neither of those are 
required as template parameters for the function's invocation. 

Get Components erates through the components thatact or has, and any 
components that inher romt ypersme T have pointers to them stored inside the 
Pri mi ti veComponents ary. 

Using a range ased* or loop, another new feature of C+, we can iterate over the 
components that the function placed into our TAr ray without needing to use the 
tradisonal or loop structure. 

Each of the components has Set Enatl eGravi tyi tal se) caled on them, which 
disables gravity. 

Likewise, the Enab! eGr avi ty function iterates over all the primitive components 
contained in the actor, and enables gray with Set nat eGravity{ true] 





Look at Chapter 4, Actors and Components, for extensive discussions on Actors and 
Components. Chapter 5, Handing Events and Delegates, discusses events such as 
Motit yAct or Over! ap. 
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Inheritin from one another 





Sometimes, you may need to create aul st ert 
Untertace 





that specializes on a more general 


‘This recipe shows you how to use inheritance with Uinterlaces to specialize a Killable 
Interface with an Undead interlace that cannot be kiled by normal means 


How to doit... 


1. Grote aU NTERFACE/I Interface calledUKi I able 
2. AddUINTERFACE| met as] Cannot I mpl ement i nterfacel nBl vepri nt) | tothe 
Uster ace declaration. 
3. ld the following functions to the header He 
ane oahu atl able, ategr yet abel 


ÜrINCTI CUR vepri ttu able, Category = Kin able 
virtual void Dieli 








4. Provide default implementations for the interface inside the implemertation He: 


hei Kit abest sbeadil 
t 
i 


vel Kili abies: biel 
( 
engi ne- »AddOnSereenDebuglessapel 1 
Feal or., Reds ierra 
dicter* Me = Cast Aactoral this 
iro 
1 


3 
5. Create anew UI NTERFACEJI I nterface called Undead- Modify hom to inherit from 








Uki tablari KUT able 
woneirac 

class UEACOOK800K d public Uribe 
t 


sENERATED, BODY (I 








i 


jai 


Class UEACOOKBQOK_API undead: public IKI ale 
( 
sENERATED, Boor) 


I 


Ensure that you indude he header debringtheti 1 abl = interface. 
Add some overrides and new method declarations to the new interface: 
virtual bool Iseadt) override: 
virtual vaid Die] override 
Virtual vaid Turat) 

virtual vaid Baa sai) 

Create implementations for th functions: 
bool Undead: Dead) 

t 

, 


veld Undead: Die] 
t 
engi ne- »adaOnSereenDebuglessagei 





1,1 Foobar: shed, "You 





fant KITI what 1s already dead. Meanaha") 
i 
vel al undead: : Turat | 
( 
engl ne- paasonSereesDebuphessagel 1,1, Ftrloriiiet, "I^ 
fieling!” 
i 
vai di Undead: bani s0) 
{ 
Mietort Me = Cast ctactarsi this 
iO) 
1 
he: sbestrayl) 
) 
1 
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3. Create two new actor classes in Ctt: one called Sa‘, and the other called 
Debe 


10. Setthe Sra: class to implement the! 1 Lat e interface, and add the appropriate 
header He e| sc! use 


11. Likewise, set the Zonbi e class to implement! Undead, and i acl ude 
Sundaes,» 


12. Compile your project. 
13. Launch the editor, and dragan instance of bathZerei e and Snai | into your level. 
14, Add a reference to each of them in the Level Blueprints- 

15. CallD|« (Message) on each reference. 





16. Connect the execution pins of the two message calls, 
egi Play 


then wire tupto Event 





Run the game, and then verify that the Zombie is disdainful af your efforts to kll it, 
tut thena! 1 roans and then dies (is removed from the ward outiner 


iia 


1. To make it possible to test this recipe in the Level Blueprints, we need to make the 
interface functions callable va blueprint, so we need the uepri nt Cal atl e 
specter on our FUNCT an. 








Capta? 





D 


However na UI nter T ace, the compiler expects the interface to be implementable 
a both Chand Blueprint bydefaul This confits withe! sepr i nt Cal 1201'e 
which is merely saying that the function can be invoked from Blueprint, not that t can 
be overridden in i 

Wecan resche the conic by marking the interface as 

Cannoti mpl ementi ntertacel néluepri nt 

This enables the use ol uepr i at Cl I abl e as ourUFUNCTI ON speciber rather 
thanBlvepri nt np! enent 261 eEvent (mhich has entra overhead due to the extra 
code allowing for tne function to be overridden via Blueprint). 

"Wedetrel sDead and Di e as vi rt ual to enable them to be overridden in another 
Ce clas which inherits this one. 


"n our defaut interface implementation, | s Dead always retums Tal se 


The defaut implementation of Di e prints a death message to the screen, and then destroys 
the object implementing this interface fitis an Act or 


1 


10. 


E 


We can now create a second interface called Undead, which inherits fom. 
cime 

Weusethe public UKi abl efpubli c 1 KI LL abl e in the class declarations to 
press this. 

Of course, as a result, we need to include the header He that dees thei | 231 e 
interface, 

(ur new interface overrides the two functions that ki | al e dees to provide more 
appropriate detritions of s0e34/0ie forUndead. 

Qurcvenidden depritions have» dead already dead by returning r ve from 
no 

When Di e is called on Undead, we simply print a message with Undead laughing at 
our feeble attempt to kil t again, and do nothing. 

We can also specify default implementations for our Ua dea -specie functions, 
mamelyTurs] andtani sht} 

When Undead are Tumed they joe, and for demonstration purposes, ve printa 
message to the sereen. 

Man Undead is Banished, however, theyare annihilated and destroyed without a 
trace. 

"n order to test our implementation, we create two Act ors that each inherit fom one 
ofthe two interfaces. 

Mer we add an instance of each actor to our level, we use Level Blueprints to 
access the levers deg: nP! ay event 
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32. When the level begins play, we use a message call t vy and al the Di e function on 
our instances. 


13. The messages that print out are different, and correspond to the two function 
Implementations showing that the Zombie's implementation af D = is different, 
and has overridden the Snails. 


Overriding Ulnterface functions in C++ 


One side effect of Unteraces allowing inheritance in C+ is that we can verde default 
implementations in subclasses as well as in Blueprint. This recipe shows you howto do s. 


Getting ready 


Fallon the recipe Cling native Unterface functions from C+ in which a Physics Cube is 
created so that you have the Class ready. 


How to do it... 
1 


Create a new interface called sel ect abe 
Debre he folining functions inside! Sel ect abe 
virtual. bool Ister ectatlel] 





Tryselecti 


virtual void Deselecti] 


3. Provide a default implementation for functions ike this: 
bool Sel ectabies-1 select able() 
i 
Gengi ne- »AddOnSereenDebugMessagel-1, 1, FColar:: Aed, 
selectable} 
i 


bool Sel ectabies:Tryselect|| 
t 
engi ne- »AddOnSereenDebuglessagel-1, 1, Feel ers: Aed, 
accepting Selection” 
, 





vol dl Sel ectable::deselect{ 








20. 


t 


uni mpi ement eat). 
) 

Create a class based on APhysi csCube calledSel ect abl eCube. 

tinci ude "Selectable. A" insidetheSel ect sl eCube clss header. 
Modifythe Asel ect ab! eCube declaration like this: 

class UEACOOKEOOK_API ASelectableCube : public 
AohysicsCabe, public 1Sel ectatle 

‘dd the following functions to the header: 


ASel ectabl ecubel) 
virtual veld Moti vH tcl ass UPri mit vetomgonest* MyCom, 
actor” Others class ubrimtiveConpenest= ther Come, Baal 
{sel fives, FvectarditLocati en. Frectardl tor mal 
Fectarnarnal Impulse, consi Phi Resalta Mit] override; 


Implement the functions: 
ASelectabl eCube: Ael ectableCubel) 

Super) 
t 

Wlest-»setoti yi gi dBadyCol List onttrue) 
, 


val daSel ectabi eCube: Moti y t class Ubri tl veCompaneat 
Mjtome, AActoc* Other, class Uri mti veCompaneat 
Ofhercomp, bos! Bsel fovea, Hettarhitrecat ron 
Fvecterm Corsa, FVectorNormal Impulse, constFAItResul té 
( 

M {isselectabtel)) 

[ 





TeySet eet ll 


) 
$ 


Create a new class, caled None! ect abl e Cube, which inherits rom 
Selecta etus 


NonSel ect al eCube should override the functions from Sel ect abl el nt erf ace 
virtual bool UsSelectable|| override; 


virtual. bool TrySelect|) override: 


virtual. void Deselect| override 


p 
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11. The nplementation He shouid be altered to include the following: 
bool aMonSel ect al cube: l2Sel ectabl el) 
t 


Engl ne- pAddOnScreenDebugMessagel-1, 1, FColar:: Aed, "Ma 
Sel errante”) 


L aonsel ectabl tube: Trysel eet 





Gengi ne- saaaonScreesDebuphessege| 1, 1, FCol ers Red. 
halusi Selection") 


vol dANanSelectabl stube: i Desel ect() 
( 

Uni mpl ement eat). 
1 


32. Place an instanceof Sel ect abl Cube into the level ata certain range above the 
around, and play our game. You should get messages vering that the actors 
Selectable, and tat t has accepted the selection, when the rube isthe ground 





13. Remove Se! ect abl eCube and replace it with an instance of lan el ect atl eCube 
to sce the altemative messages indicating that this actor isn't selectable, and has 
refused selection. 








1. We create three functions inside the Se l ect abl e interface 

2, Sel ect ab! e retums a Boolean to indicate if the object is selectable. You could 
avoid this and simplyuse Tr ySel ect, given that it returns a Boolean value to 
indicate success, but, for example, you might want to know if the object inside your UI 
i a valid selection without having to actualy ry, 

3. TrySel act actualy attempts to select the object. There's no elit contract forcing 
users to respects Select abl e when trying to select the object, sor ySel ect i 
named to communicate that the selection may not always succeed. 

4. Lastly Dese ect is a function added to alaw objects to hande losing the player 
‘selection. This could involve changing the UI elements, haing sounds or other visual 
‘effects, or simply removing a selection outline from around the unit 

5, The defaut implementations of the functions retumt rue forl sSel ect able (the 
delaut i for any object to be selectae t ve Tor Tr Se ect [selection attempts 
lays succeed), and issues a debug assert ifbesel ert is called without being 
implemented bythe class. 

6. Youenuid alsa implement Desel ect as a pure virtual function if you wish. 


T, Sel ectabl acute isa new class inheriting from Physi cs Cube, butalso 
implementing the Selectable interface. 

8, ako ovemides Noti tyki t, avi rt ual funcion defned in ket or that triggers 
hon the actor undergoes a RigidBody colision. 

9. We call the constructor from Physi cs Cube with the Super (| constructor call inside 
the implementation of Sel ect ab’ eCube. We then add our own implementation 
mhich cals set eti yRi gi dbedyCol Lisi oa(true) on our statie mesh instance. 
Tris is necessary because by defaut, RigidBodies (such as Pr i mi t i veComponents 
vith a colision) dont tigger Hi t events as a performance optimization. As a resut, 
Gureverióden Not i tyhi £ function would never be called 

10. Within the implementation of oti i t we cll some ofthe Select abl e 
Interface functions on ourselves, Given that we know we are an object that inerts 
from Selectable, we dont need to casto an! Sel ect ael e" in order to cal 
them. 


11, We check to see ifthe object is selectable with! Selectable, and i's, we try to 
actually perform the selection using Tr ysel ect 

32. NonSel act a8 eCube inherits from Sel ect ab! eCube, so we can force the object 
to never be selectable, 

13. We accomplish this by overtiding the 5e ect abi e interface functions again. 


24. Within ANonSel ect abl eCube:: | Sel ect abl el ), we printa message to the 
screen so we can verify that the function is being called, and then return sl se tD 
indicate that the object isnt selectable at al 
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15. In case the user doesnt respect! sSel ect abl e(]. 
‘AMonSel ect abl eCube: :TrySel ect) always retums f al se to indicate thatthe 
Selection wasnt successful 

16. Ghen that itis impossible for on Sel ect abl eCube to be selected, Dese! e 
alis uni mal ement edi |, which tous an assert warning that the function was not 
implemented. 

17. Non when playing your scene, each time Sel ect al eCube/NonSel ect atl eCube 
hits another object causing a RigidBody colision, the actor in question will attempt to 
Select elf and print messages to the screen. 


See also 


‘Refer Chapter 6, Input and Collision, which shows you how to Raycas from the 
mouse cursor into the game word to determine whats being clicked on, and could 
be used to extend this recipe to allow the piayer to click on items to select them 


from a nativi 





Being abie to dee nt erf ace methods in C++ is great, but they should be accessible 
from Blueprint to. Otherwise, designers or others who are using Blueprint wont be able 
to interact with your UI terface. This recipe shows you how to make a function from an 
interface callable within the Blueprint system. 


How to doit... 


1. Createaulntertace called Post Segi nPI ay Post Begi nPlay 
2. Add the folowingvirtual method tol PostBegi say 

UFINCTI Ou i uepriatcallable, CategeryeTesti 

virtual void OnPost gi Pl y) 
3. Provide an implementation of the function: 

voi di Post Begi s ay: : OnPost Begi el ayl 

( 

Engi ne- hdétrScreesDebaplessage-1, 1, Fol er: Red 


Pastei nay called") 
i 


4. Create a nen Act or class called Post Begi nPI ayTest 
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5. Modify the clase declaration so that it als nherlsi Post eni nPI ay: 





ucussi 
lass MEACBOLEDOC J|. APosteginblayTest : public Actor, 


15. Compile your project Inside the editor drag an instanceof Pas t £e 
into your Jewel. Wih te instance selected, ck on Open Level Blueprints 





ames 








8, Drag away rom the blue pin an the righthand side of our actar reference, then 
search the conte menu foranpost to see your new interface function avlatie, 
iek on ila inserta calito your native Ul ater ace implementation from Blueprint 
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3. Finally, connect the execution pin (aite arn) trom the Begi n? ay node to the 
emcution pin forOn?ast Begin? 


20. When you play your level, you should see the message PostBepinPlay called visible 
on screen for a short amount of ime verifying that Blueprint has successful 
accessed and called through to your native code implementation of the 


1. The Ul WTERFACE/I I nter ace pair function as in other recipes, withthe 
Ulter? ace containing rejection information and other data, and e| I ater t ace 
functioning as the actual interface class that can be inherited from. 

2. The most sigriþcant: element that allows the function inside nt erf ace to be 
exposed to Blueprint is the UFICTI ON specter. 

3 Blueprint Col abl e marks this function as one that can be called from. 
the Blueprint system. 

4. Aoyfunctons exposed to Blueprint in any way require a Cat egar y value 
also. This Cat egor y value specipes the heading under which the function wil be 
isted in the conto menu 

5. The function must also be marked vi rt ual -this is so thata class that 
implements the interface va native code can override the implementations 
of the functions inside ic Without te vi rt ua! speciper the Unreal Header 
“oo wil ve you an errar indicating that you have to either add vi r tual or 
iuepri ntl spl ement a6] eEvent asa UF UNCTI ON spacer 

6, The reason far this is that without ther f those, the interface function wouldnt 
be overidable in C++ (due to the absence of vi rt sl) or Blueprint because 
lvepri rtl eol ement abl eEvent was missing. An interface that cant be 


overridden, but only inherited, has limited uit o Epc have chosen not to support It 
within Uintertaces. 








T. We then provide a defaut implementation of the 0n Post Begi n?! zy function, which 


uses the Engi ne pointer to displaya debug message cortringthat the function 
was noke 








Chapter 


See also 


‘eer to Chapter 8, Integrating C++ and the Unreal Ector, for a number of recipes 
showing how you can integrate your Ce classes with Blueprint 


Implementing Ulnterface functions in 
Blueprint 


One of the key advantages of Unterface in Unreal is the abit fr users to implement 
Uinter taze functons in the editor. This means the interface can be implemented sty 
in Blueprint without needing any C++ code, which i helpful to designers 


How to do it... 


L. Createanen inter? 





called At tackle der 





2. Add the folowing function declaration to t 





header 
Category dtc der) 





3. Crate a new Blueprint Class within the Editor: 
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4, Base the class on Actor: 





m 


CUE 





5. Open Class Settings: 





6, Click on the dropdown menu for implement Interface, and select AtackAveider: 





7. Compile your blueprint: 





Chapter 








3. Rihtclck inthe Event Graph and ype event att ack. Within the Context 
Sensitive menu, you should see Event Attack Incoming. Select tl place an 
‘event node in your graph: 





3. Drag aut from the execution pin on the new node, and release. year int strin 
into the Context Sensitive menu to add a Print String node. 





10. You have naw implemented a UI nt er tace function within Blueprint 


1. Tell WTERFACE/I| ater fare are created in exactly the same way hat we seein 
other recipes inthis chapter. 

2. When we add a function to the interface, however, we use a new LFINCTI ON 
specter al oepr st! mpl sment at eter 

3, luepti nti mpl eentabl event tells the Unresl Header Tool to generate code 
that creates an empty stub function that can be implemented by Blueprint We da not 
need to provide a default C++ implementation for the function. 











Communication between Clases and interfaces 
4. We implement the interface inside Blueprint, which exposes the function for us ina 
vaythat alous us to depne s implementation in Blueprint. 


5. The autogenerated code created bythe header tool forwards the calls to the 
Uintert ace function to our Blueprint implementation, 


^ Thefoloningrecpe shows you how to debne a default implementation for your 
Uster ace function in C++, then optionally override itin Blueprint if necessary 


Creating C++ UInterface function 
implementations that can be overridden 


in Blueprint 





Just as with the previous recipe, Unterfaces are useful, but that ubityis severely limited 
without their functionalty being usable by designers. 


The previous recipe shows you how to call C++ U nt er ace functions from Blueprint; this 
recipe wil show you how to replace the implementation of a UI at er ta ce function with your 
own custom Blueprint only function. 


1. Create a new interface called Wear abl e ( Wearable, Ulearabl e). 
2. Add the folowing functions to the header: 

UFUNCTION Bi vepri atnativetvent, BlveprintCallable, Category 
Tersteststrengthtemi rement| 
UFINCTI OU M vepriatnativeevent, BlueprintCallable, Category 
Yel d0eEquip(APaun* Wester) 





3. Ad the flowing function implementations in the implementation He: 


int32 arab ec Get rens hh 
( 
" 











Bool tear abl eis Cantgulp_lmplementati on Pt wearer) 
t 
] 


Vaid 1 Wearables: OnEquip_laplementation| Pawns wearer 


£ 


i 


Create anew Actor class called 8oot s inside the edor. 
Add incl ude "Wearable." totheheader Befertoct 
Modiy the class declaration as follows: 


ucusst 
lass EACOOKBOOKLAPI Mets : public Mtor, public 
Tiri 


‘Ad the following implementation of the pure v ta! functions created by our 
Interface 
virtual void Qnequip.taplenentation| Paw wearer) override 


t 


Larabie: Orgel p_i mpl enentati os| Wearer) 





i 
Virtual boot Canéquip, implementati on(APaun* Wearer) override 
( 

return {Wear bl e::Can€gul p_i mpl ementati os] Wearer) 
] 
Virtual 10132 GetStreagthRegulremeat | eplenentati |) override 
( 

Tiatabl e:: Get Strengt hhegui renent „i mpl ement atl 0 
J 


Create a new Blueprint class called aves based on Act or 


Inthe class settings, select Wear ab! e as the interface thatthe GI oves actor 
wi implement. 
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10. Within ves, overide the OnE cui p function like this: 








11. Draga copyaf both Gi aves and oct into your leve for testing purposes. 
12. Add the folowing blueprint code to your levet 





13. Verfythat at s performs the default behavior, but oves perform the blueprint 
deri behavior. 





How it works 


1, This recipe uses two UFUNCT! ON specipers together 3 
Blueprint Cal able 


2, Blueprint CaL able hasbeen shown in previous recipes, and is a way of marking 
your UFUNCTI OW as visible and invokable in the Blueprint Editor. 
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3. Blueprint lati vevent sigubes UF UNCTI ON that has a default C+ (native 
ade) implementation, but is also overridable in Blueprint. ls the combination of a 
virtual function along with I vepri nti ml ement abl ef ven 

4. In order for this mechanism to work, the Unreal Header Tool generates the body 
of mour functions so that the Blueprint version of the function is called text 
otherwise, it dispatches the method call through to the native implementation: 

5. In order to separate your default implementation from the dispatch functionalty 
though UHT denes a new function that takes its name from your declared function, 
butappends „1 npl ement ati on tothe end. 

6, Tisis uhythe header Dededares Get Strengt hegui rement, buthas 
no implementation, because that i autogenerated. 

T. Itis also wy yur implementation Be debnes Get St rengt hAegui renent 
mel ement at on, but there is no declaration for it, because Ls also 
autogenerated. 

8. Theioot: class implements I Wear ah e, but doesnt override the default 
functionality However, because the _1 mel ementat on functions are dened as 
virtual, we stil need to explicy implement the interface functions, and then call 
the defaut implementation directiy 

9. In contrast Gi oves also implements! Wear ati e, but has an overridden 
implementation for OnE qi p dened in Blueprint 


10. This can be veriped when we use Level Blueprints to call 0n Egui p for the two actors. 


Calling Blueprint-depned interface functions 


from C++ 





While the previous recipes have focused on C+ being usable in Blueprint, such as being able 
to call functions from C++ in Blueprint, and override C+- functions with Blueprint, this recipe 
shons you the reverse: calling a Blueprint depned interface function from C 


How to do it. 


1. Create a nemi ntert ace caled UTal ker JI Tal ker 


2. Add the folowing UFUKCTI ON implementation: 


UFUNCTIOM Bl pri etnativeEvent, Blueprintcallable, Category 


Taid StartTalti nall 








Tj 
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3. Proide a default empty implementation inside th cpp He: 
void (Talkers: StartTal ting, I mpl emeatati ont) 


( 


j 


4. Create a nen clas based on St ati eMeshact or 
5. Add include and modify the class declaration to include the talker interface 
#i ncl ade Haltern 


Class UEACOOKBOOK-API Aal Ki nguesh © publie 
Astati es actor, public ITalker 


6. Aso, add the folowing function to the class declaration: 
vaid StartTal king implementati onl) 


7, Within the implementation, add the folowing to the constructor: 

ATH noeh: :ATal ti ngheshi | 

Saperi) 

t 
autanesnasset = 
Constructor Hel pers: FObj ect Fi nder usta cesh» 
[TEATU Stati eNesh (Engine Bast estapass Cube. Cabe “| 
if [WesnAsset. Object t= nuliptr) 
i 


Getstaticueshcompenent || 
SsetStatl ess Mes Asset, Obj ect 
[Get stati cMeshconponent [) 
Sseteal it siontrat etme 
Citar is anbratite: Pawn „Profi I enane) 
Get Stati cMeshConponent | >bGenerate0ver Iapëvents = 
) 
Get Stati cWeshcomponent() 
Set Wabi i tyl ECorposent Mobil it y: Movable} 
SetActorEnatl eCol isl oni truel 
] 
epiperert the default implementation of oar StartTal king 
Ferran 
VEHRATET Ki nglesh: Start Ta ti ng. Impl emeataten() 
t 
Engi ne- »addOnScreenDebughessagel-1, 1, FColor:: Aed, 
TESTI ella there mat is yaur same] 


i 
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3. Create a nen clas based on Det au! t Pawn to function as cur player character. 
9. Add some UPAO?ERTY /UFUNCTI OK to our class header: 
n 
UsoxCemposent® Tal Cel Lider 
vrincrro 
vol dOsTal eQver|ap|Adctor* Diherdetor, Ubri miti vetumponent" 
Orhercomp, int32 OtherBodyinden, basi BFromSmeep, 
ConsteAlthesutasneephesut] 





10. Modify the constructor: 
Atal ki ngPawn: Ta nga 
Saperi) 
t 
1 Set thls character te cali Tick() every frame. toe 
can tura this off ta Improve performance IF you dom 


FrimaryActorti ct beangverti ck = true: 
Talecal ider = 


CreateDet aul tSubob] ect <UBoxConponent | "Tal kCal lI der") 
Tal eco tider- >SetBonExtent (FYector(200, 200, 10011 
Tal tolii der- »0nComeonent Begi nover lap. MéDynari ci th s 
SATa lki spawn Onal toveri ap) 

Tal ecol i der- tac Tel Reet Component] 

' 


11. implementonTa I Overlap 
vaidATalkingPawn: :OnTalkOverl apl aactor” Other Actor 
Urrimtivetonponest® Orhertom. int32 OtherBodyinden, bool 
Mireriwesg, const? therutGSweephesul t] 
( 
1t otheraeter-scetel aes) 
>i mel ementsi nter Facel Ta ter: Stati ctl asst) 





Mal ker: Execute, start Tali ag(atherActsr) 


D 
3 


32. Create a neu Gamelioge, and set Tal ki ngP awn as the default pawn class 
forthe player. 


13, Drag an instance of your Ts ki ng Mesh class into the level. 
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14. Create a nen Blueprint class based on ATal Vi ngles® byrightelicking anit and 
Selecting the appropriate option frm the contet menu: 





15. Nameit HyTal ti ages 


16. Inside the blueprint etor, create an implementation forst ar t Tel kin Ike this: 


Rad 





37, Draga copyof your new Blueprint into the level beside your aTa! ki ngNesh instance. 

18. Walk up to the tun actors, and verify that your custom Pawn is correct invoking 
either the default C++ implementation or the Blueprint implementation, as 
‘propa 








-gnj 





1. As always, we crete a nowintertace, and then add sore function debritions tothe 
avert see cass. 

2. Weuse thes! vepri nt at veEvent speciper to indicate that ve vant to dedarea 
default implementation in C++ that can then be overridden in Blueprint. 

3. We create a neu class (inhertingfrom St at i cNeshact or for convenience), 
and implement the interface on it- 

4. in the implementation of the new class constructor, we load a static mesh, 
and set our colision as usual 

5. We then add an implementation for our interface function, which simply 
prints a message to the screen. 

6. If you were using this in a fullblown project, you could play animations, 
play audio, aer the user interface, and whatever else was necessary to starta 
Conversation with your Tal ter 

7. Atthis point, though, we dont have anything to actualy callst ar t Tal ki ng on our 
Talker 

8, The simplest way to implement this is to create a new Pa wn subclass (again, 
inherting from Det au t Pawn for convenience) that can start talking o any Tal ker 
actors that it colides with. 

3. In order for this to work, we create a new dox Component to establish the 
radius at which we wil tigger a conversation. 

20. As always, itis a PROPERTY , so went get garbage collected. 

11. We also crente the dentin for a function that wil get triggered when the 
nen BoxCanponent overlaps anther Actor in the scene: 

12. The constructor for ourTa! ti ngPa n initializes the new BorComponent 
and sets its etens appropriately, 

13. The constructor also binds the OnTa kOver| ap function as an event 
handier to handle collisions with curtes Cerpe nen 

14. Itaisoatlaches the box component to our Root Component so that it moves 
ith the rest of the player character as the player moves around the level. 

15. Inside OnTal kOver 1 ap, we need to check if the other actor, which is 
‘overlapping our box, implements the Ta! ker interface. 

16, The most reliable way to do this is with the I mp! ements! nt er face function in 
UCI ass. Tis function uses the class information generated by the Unreal Header 


Tool during compilation, nd corectly handle both C++ and Blueprint implemented 
interfaces, 
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17. tthe function returns t r e , we can use a special autogenerated function contained 
in ouri 1 ntert ace to invoke the interface method of our choice on our instance 

28. Tis is a static method of the form <I | nterface»: : Execute <Functi omame»: 
"n cur instance, our! nterface isi Tal ker, andthe function is Start Ta! ki ng, 
Sothe funcion wewantto make le|Tal ker! -Execute Start Talking) 

19, The reason we need this function is that when an interface is implemented in 


Blueprint, the relationship isn't actually established at compile time. C++ is, 
therefore, not aware of the fact that the interface is implemented, and so we cant 


cast the Blueprint class tol nt er face to call functions direct. 

20. TheExecut e, functions take a pointer to the object that implements the interface, 
and call a numberof internal methods to invoke the desired function's Blueprint 
implementation. 

21. When you play the level, and walk around, the custom Pa wn is constantly receiving 
natications when ts BoCempenent overlaps other objects. 

22. If they implement the UTa ter /ITal ter interface, the pawn then tries to 
inke startal king onthe Act ar instance in question, which then prints the 
appropriate message on screen. 





Implementing a simple interaction system 
with Ulnterfaces 





‘This recipe wil show you how to combine a number of other recipes in this chapter to 
demonstrate a simple interaction system, and a door with an interactable doorbell to cause 
Me door to ope. 


How to do it. 


1. Create a new interface, intera 





able 


2. Add the folowing functions tothe nt er act able class declaration: 
UFINCTI OU B vepri nati veEvent, BI vepri ntCal lable, 
Gteperyetitersctablel 
bool Cantateraetl) 

UFINCTI oh Bi vepri atnativetvent, BlveprintCallable, Category 
nteractablel 

Vel dPertoral nteract() 








3. Create deat implementations fr both functions in the implementation þe: 


ts A E 


, 








10. 


veld nteractables:Perteralate 
Í 





ct „implementati ont) 


d 


Create a second interface, Openab e. 
Add this function to its declaration: 


UFUNCTIOM Bi vepri nat ivetvent, Bl vepri ntal lable, 
Categorys0penabi el 
veld Openi) 





Ae with interact at e, create a default implementation for the Doer 
uncton 

‘vail Operable: Open. Lol ementati ont 

n 

D 


Create anew class, based on tati ceshact or, called Deer! | 
fincluge *Interactable. A" inDeorbel 1h, and add the folloning functions to 
the class declaration: 

virtual bool Caniateract_inplementation|} override 

Virtual vold Perform steract_taplenentat|on|) override 

ÜHRCHEATH al vepri ntReadik ite, Edi tAnyuterel 

Adctar® DaarTa0pen 


private: 
bool Hasdeenusnes 


Inthe. cpp HeferDecr ell „si nclude "Openabl e. h" 
Load a statie mesh for our Door Be! | in the constructor: 
HasteenPusnes = false: 
astoNeshasset = 
Constr uctartel pers: Fob) ectFl der elstati esto TEXTI "Stati e 
Mash | Engine asl eshapes/ Cube Cube” =H) 
1E CNeshasset-Objert te muliptri 
( 

Getstati cHeshtomponent (1) 

Set Stat chash MeshASS8t, Ob] eet) 

J Gatstati csesncenparent |) 

Set Col si anPraf i| ekamel Col Lisi onProfi le 

Pawn Profil etme) 

Get Staki cWeshComponent(|->bGenerateQverlapévents = true 

i 
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GetstaticHeshcomponent |) 
Seti ty Conponest Nabi |i ty:: vat e) 
GetStaticuetnconponent|)-> Set her! aScal e30l FVector| 5 
DET 

Sethetortestl tol isi nl teue) 


bear Tepes = eult ptr 


11. Add the following function implementations to implement the 
Inter set able interface on cur Daor Bel | 
bool ADoor Bells: Cael mteract mpl emestaten() 


t 


return tHasēeenPushed: 
i 


vel daboor Bells: Pertormlmteract mp! emeatati enl] 


( 


testeenvushee = true 


If (Doar Tedpen- Get classi 
implement st ntertace| UOpenable:: Stati cC 455011) 


i 
| Operable: Execut¢_Open! boorTaoper 


D 
$ 

32. Now create a new Stati cMeshact or -based class called Door 

13. include the Openable and intractable interfaces into the class header, then 
modify Doors declaration: 


tlass UEACOOKBOOKAPI ADoar : public AStaticWeshactor 
Publie Hateractable, public |penable 








24. add the interface functions to Door 


Uruncri on 
virtual bool Caalateract.tnplementatlasi) override | retura 
Tiateractabl ess Cant ateract implementati ont); Hi 


veunert out 
virtual void Perform eteract, implementati s] override 





urine out 
virtual vaid Open, taplemestati al) override 
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15. As with Door Bel |, In the oor constructor, initialize our mesh component, and load 
a modelin: 
autoleshasset 
Canstfuctarhel persi: Ob etfi er elstati esto TEXTI "Stati e 
Nes I Engi ne Basi eShapes/ Cube. Cube” *)) 
1 (Neshasset-Objert te mali pte| 





Get staticMeshComponent(| 
Sset Stat icNash( MeshAsset, OB] ect). 
[i Gatstati cesncenparent | 
DSeiCol isi onPraf Il exams] Co! Iisi onProfi le 
Pawn Proti ele) 
Get Stati Mes Component () »tGererat everlapévents = true 
} 
Getstaticueshconpenent |) 
SSetbi tye Ecomseneet Nabi Lit yi Moab e) 
Get StaticMesnconponent 9- Set or Scal Pictor, 2 
" 
Sethetortesil etol isi (true). 


16. Implement the interface functions: 
vaidADoor: Perform nteract Impl emeatati ont) 
( 


Engl ne- shaonscreesbebusMessage| 1, 5, FColar:: Red 
Tii The aaor refuses ef budge Peraaps There dria 


Midden switch nearby? )i 
í 


vel dADoor: Open, mpl esent ation 





MükctorLocatO t set ectorto, 0, 2001): 
i 

17. Create a neu Def aul t Paun based class called Al ater acti nghe. 

18. Add the folowing functions to the Pawn class header: 
vaidTeyinteract() 


private 
Virtual void SetupPlaperl eput Component UI nput Component * 
Tatapatcoaponent) override 





m- 
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19. Inside the implementation He forthe awn, #i ecl ode *Interactabl e le, 
and then provide implementations fr both functions from the header: 


vol dAlnteractingPaan:: Try! ateract(] 
( 
aplayerconteol er aycostral er 
{het capi ayer Cont rol ers Central lor] 
if Ditontrall er] 
' 
APiayertameraManager* MWyCameraManager = MyConteoll er 
SPiayerCameramanager, 
futostart location = NyčameraNanager: 
Stet CaneraLocati onl): 
futatodLecstl on = WyCameraanager->GetCaneraLocati anl) 
Pinjeaneransnager-sGetacterForaravector(] * 100) 
Faithesul tenuit 
Get War d(|->SweepSi ngl e808) ect Type Mi Result 
StartLocat ions EnaLocation, Foust Identity, 
Fol sent] ertoseryharams 
(Fal si enibj ect Query Params: i AlI OBJ ects) 
Feollisioashapes Makespher el 231 
FC isionqueryParans Namel ateractl ont) true, this)) 
1 Ol Result Actor! null pte] 
t 
Lf Di tUlesul t kcter-»tetel asst) 
Siml enentst nter tace lt er act abl ei: Stati ctl ass(] 1) 
i 
u 
(interact ables: Execute Canl nteraci 
(thesi t Ret or etC IT 
t 
Iinteractabie:: Execute Pertorninteract 
T tesa t Arbor detii 
, 
D 
i 








à) 
i 
‘oldAlnteractingPaun:: Set player! aput Component | UI aput Compe 
nent! Tat put Component 
t 
Super: Setup ayeri aput Corposent 1 nl aput Component | 
Inl aput Companent->8i actioni "Interact", 1E Released 
this, ME rteracti gam: Tryinteratt] 
i 
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20. Now, ether create anew Game ode in C++ or Blueprint, and set! nt er acti agaw 
as our default Pawn cass, 


71. Draga copyof both Door and Doar belt into the levet: 





= 


22, Use the eyedropper beside daabel’s Door ta Open, as shawn in the following 
screenshot, then clk on the door actor instance in yout evel 








23. Create a new Action binding in the editor called | nt er act, and bind itto a key of 
your choice: 








gn- 
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24, Play your level, and walk up to the doorbell. Look at t, and press whatever key you 
bound! nteract with. Very thatthe door moves once. 
25. You can also interact withthe door directiyto receive some information about it 


1. Asin previous recipes, we mark UF UNCTI OW as BI uepri at Mati veEvent and 
Blueprint Cal able In order to allow the Ul nt er! ace to be implemented in 
‘either native code o Blueprint, and allow the functions to be called with either 
method 

2. We create Door Bell based an stati cNeshActer for convenience, and have 
Door el implementthe! nt eract able interface. 

3. Inside the constructor for Door Be! | , we initialize Has BeenPus hed and 
Dvor Te0pen to the default sate values: 

4. Within the implementation for Cas! nt er ac t, we retum the inverse of 
Has BeenPushe so that once the button has been pushed & cant be interacted 
wit. 

5. Inside ert oral nter act we check if we have a reference to à door object 
to open. 

6. If me have a valid reference, we verify thatthe door actor implements 
Openabi e, then we invoke the Open function on our door. 

7. Within Door , we implement both nteract abl e and Openab e, and override the 
functions from each 

8. WedepnetheDoor implementation of Cani nt eract to be the same as the default 

9. Within Perf or m nt er act, we displaya message to the user. 

10. Inside Open, we use debct or Local Of set, to move the door a certain 
distance away, With Timeline in Blueprint or a linear interpolation, we could make this 
transition smooth rather than a teleport. 

11. Lastly, we create a new Pawn so that the player can actually interact with 
objects. 

32 We create aTr yI nt er act function, which we bind to the! nt er act input 
action in the ovenidden Set upP I ayer! ngut Component funcion. 

13. This means that when the player performs the input that is bound to I ater act, our 
Tryinteract function wili run. 


14. Tryinteract gets a reference to PI ayer Contr ol Ier, casting the generic 
controller reference that al! Pawns have 
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a. 


x. 


ES 


E 


20. 


a 


22 


Player Caner aManager is retrieved through PI ayer Cont rol er, sowecan. 
access the curent location and rotation of the player camera, 

We create start and end points using the camera's location, then 100 units in the 
“fornar direction away from the camera's location, and pass those into Get Word 
SweepSi ngl e800] ect Type 

This function takes in a number of parameters Hi t Res lt isa variable that 
allows the funcion to retum information about any object hit by the trace. 

Cal 1 si ants] ect Quer yPar ams allows us to specify i we are interested in 
dynamic, static items, or both. 

We accomplish a sphere trace by passing the shape in using the 

MakeSphere function. 

Sphere traces allow for slightly more hurran error by dering a inde to check for 
objects rather than a straight ine, Given that the players might not ook exact at 
your abject, you can tweak the spheres radius as appropriate. 

The pral parameter, Sueep5i ngl e&y0bj ect Type, is a struct that ges the trace a 
name, lets us specify i we are coliding against complex colision geometry, and most 
important allows us to specify that we want to ignore the object which is initiating 
Me trace. 

Mhi t Resul t contains an actor after the tace done, we check ifthe actor 
implements our interface, then attempt to call Canl ater act on it 

ithe actor indicates yes, can be interacted with, so we then tell it to actually perform 
Me interaction, 





Integrating C++ and the 
Unreal Editor 


IN this chapter, we wil cover following recipes: 
Unga class orst ruct as a blueprint variable 
m Creating classes or structs that can be subclassed in Blueprint 
= Creating functions that can be called in Blueprint 
^ Creating events that canı be implemented in Blueprint 
*— Exposing multicast delegates to Blueprint 
Creating C++ enume that can be used in Blueprint 
= Editing class properties in diferent places in the editor 
^ Making properties accessible in the Blueprint editor graph 
= Responding to property- changed events from the editor 
= Implementing a natie code Construction Script 
= Creatinga new editor module 
= Creating new toolbar buttons 
= Creating new menu entries 
= Creating a new editor window 
= Creatinga new Asset ype 
= Creating custom conte menu entries for Assets 
= Creating new console commands 
= Creating a new graph pin visualizer far Blueprint 
= Inspecting types with custom Details panels 
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Intro ion 


One ofUnreals primary strengths Is that it provides programmers with the abilty to create 
Actors and ather objet that can be customized or used by designers in the edir This 
chapter shows hou. Following that, we wil ry to customize the editor by creating custam 
Blueprint and Animation nodes fom scratch. We wil also implement custom editar windows 
and custom Details panels for inspecting the types created by users. 





Using a class or struct as a blueprint 
variabl 





Types that you declare in C++ do not automatically get incorporated into Blueprint for use as 
Variables. This recipe shows you how to make them accessible so that you can use custom. 
native cade types as Blueprint function parameters. 


How to do it.. 


1. Create a new class using the editor, Unlike previous chapters, we are going to create 
an Object based class. Object int visible in tne default ist o common classes, so we 
need o tick the Show all classes button in the editar U, then select Object. Cali your 
nen Object subclass Ti | eType. 





Choose Parent Class 





2. Add the folowing properties to the Ti 1 eTj pe depnition: 





nmm 
int32 Navenent cos 
Pope 
nu 


3. Compie your code. 
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Inside the editor, create a new Blueprint class based on Act or CalltTiL 





5. Within the blueprint editor for Ti e, add a new variable to the Blueprint: Check the 
ist of es that ou can creat as variables, and vey that T| I eT pe is not there, 





5. Rddtl uepr i ntType tothe UCLASS macro as folos: 
UCLASSI a vepri ntType) 
class UEACOOLEOOK APL UTIVeType : public VON ect 
t 


7. Recompile the project, then return to the Ti 1e blueprint edar. 
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3. Now when you add a new variable to our actor, you can select Ti eT se as the type 
for your new variabile. 





3. Weve now established a tasa" relationship between Ti | e andTi I eT Be 


10. Now 1 eTy2e is a Blueprint type that can be used as a function parameter. 
Create a new function on yourTi |e blueprint called Set Ti | eT pe, 
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12. Set the input parameter’ type toTi LeTyge. 





13. You can drag our 





variable into the viewport, and select Set. 
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1. For performance reasons, Unreal assumes that classes donot require the otra 
rejection code that is needed to make the Spe available to Blueprint. 


2. We can override this default by speciying I vepr i nt Type in ourUCLASS macro. 


3. With the speciper included, the type is now made available as a parameter or veriatle 
in Blueprint, 


There's more. 


This recipe shows that you can use a type as a function parameter in Blueprint if its native 
code declaration includes BI eni st Type 


Howescr at the moment, none ofthe properties that we denedin C+ are accessible to 
Blueprint. 


Other recipes in this chapter deal with making those properties accessible so that we can 
actually do something meaningtul with our custom objects. 


ng cla or sti tcan be 


ed in Blueprint 





While this book focuses on C+- hen developing with Unreal, a more standard wero is 
to implement core gameplay functionality as meli as perormance-ciical code in C+, and 
expose thase features to Blueprint to allow designers to prototype gameplay, which can then 
be refactored by programmers with additional Blueprint features, or pushed back down to the 
Cht layer. 


One of the mast common tasks, then, is to mark up our classes and structs in such a way that 
they are visible to the Blueprint system, 


How to do it... 


1. Grote a new Act or class using the editor wizard; call itSaset nem. 


2. Add the folowing UPROPERTY to the class: 
incre 
FStriag Wapoelane 
pom 
1832 Maxi rural th 
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Add the following dass speciper to the uc ASS macro: 
UeLAssi a vepri ntabl e) 
lass UEACOOKBOOK,API AðaseEnemy : public Actor 


Open the editor and create a new blueprint class. Expand the list to show all classes 
and selectourBaseEneny c! ass asthe parent 








Name the new Blueprint Enemy Gob i n and open it in the Blueprint editor, 


Note that the UPROPERTY macro we created earlier stil aren't there because we 
haven't yet included the appropriate markup for ther to be visible o Blueprint, 


1 


The previous recipe demonstrated he use fI uepr ot Type asa class speciber, 
Blueprint Type allows the type o be used as a type within the Blueprint editar 
(that, can be a variable or a functan input retum value) 

However, we may want to create blueprints based on our type (using inheritance) 
rather than compastion (placing an instance of our bpe inside an Act ar 

for ample). 





m- 
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3. This is why Epic provided a epr i nt abl e asa dass speciber BI uepri nt abl 
means a developer can mark a class as inhertable by the Blueprint classes. 

4. Wehave both! uepri ntType andal uepri stab! e instead ofa single combined 
Specber, because sometimes, you may only wart partial functionality For sample, 
ertain classes should be usable as variables, but performance reasons orbid 
creating hem in Blueprint In that instance, you ould use BI uepr i st Type rather 
than bath specipers. 

5. On the other hand, perhaps we want to use the Blueprint editor to create new 
‘subclasses, but we dont want to pass object instances around inside thec t or 
blueprints. tis recommended to use uepr at abl e, butomitBl vepri rt Type in 
this case, 

6. As before, neither BI uepri nt abl e oral vepri nt Type spedbes anything about the 
member functions or member variables contained inside our class. Well make those 
avaiable in later recipes, 





While marking classes as vepri ntType orBluepri nt abl e allows us to pass instances 
of the dass around in Blueprint, or to subclass the type witha Blueprint class, those spacers 
dont actually say anything about member functions or variables, and if they should be. 
exposed to Blueprint. 


This recipe shows you how to mark a function so that it can be called within Blueprint graphs. 


How to do it.. 


1. Createanewact or class using the editor. Call the actors i di ngDoor 
2. Add the folowing PROPERTY to the new class: 

UFUNCTIOM B vepri stat lable, Category = Deer 

vaid Openi) 

Pope I 

baal 1098 





Property| 
Fecter Target Locatia 








3. Create the class implementation by adding the folowing to the. cpp He: 
ASI i di ngDoor: Sliding or 
Superi 
t 
auta Meshasset 
Constructor Ael pars:: 0b) ect Fi nder «ustati Hesh» 
[TEXTI Stati cas (Engine Basi estapas) Cute, cute!) 








1f Destksset 08) ect t= nuliptr) 
[ 

Getstaticueshcomponent || 

eet Stati ces M Mes set. Obj ect) 

GetStati clesh Component | ->8GenerateOverlapevents = 
) 


Get stati cWeshtomponent (1 
>Set Mabi Ii y Component Mobi ty: Nova e 
fet Stati Meshtomponent (1->Set Port eat e301 letter, 2 
Set Actor Enabl ecol lisi oni 
Isopen = false 
Pri mar yator Tick, tart ENT elei et = true 
Pri mar yActor Tick Canevari ck = true, 
] 
Vaid ASHI dingDoor: Open 
t 
Targetteration = 
‘eter Towrl dl). TranstormPosi tionNoscale(fVector(0, 0. 
aoon 
IsOpen = trae; 








" 
veld ASI ng Door: Ti ctt oat Del taeconds] 
t 
if istpen) 
[ 
gethetrLocat  on( Fats: Lerpl Get aeterLacat enl] 
Target Lacatign, 0 05)1 
D 
i 


4. Compile your code and launch the editor. 
5. Draga copy of your door out into the level. 





T 
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6, Make sure you have yours! i di ngDeor instance selected, then open the Level 
blueprint Right ick an the empty canvas, and expand Cali function on Siding 
Door 








T. Expand the Door section, then select the Open function. 





3. Link the execution pin (white arrow) from tegi vl ay to the white arrow on the Ope 
node, as seen in the following screenshot 


= 








Chapters 





2 


Play your level, and very thatthe door moves up as expected when Open i invoked 
(on your door instance. 











1 


Wein the declaration of he door, we create a new function far opening the door, 
a Boolean to track if the door has been told to apen, and a vector allowing us to 
precompute the target location of the dor. 

We also override the Ti ct actar function so that we can perform some behavior on 
every frame, 

Within the constructor, we loadin the cube mesh and scale it to represent our door. 
We aso sets pen to a known good value of se and enable actor ticking by 
Using bCangverT ek andastartWitaT: ck Enabled 

These tuo Booleans control if ticking can be enabled for this actor and if ticking 
starts in an enabled state respecte 

Inside the Open function, we calculate the target locaton relative to the doors 
starting pest 

Wealso change the 0s Boolean from al se tot rue 
Now thatthe) sOpen Boolean itr ue, Inside the T rk function, the door tries 
to move itsel towards the target locaton using Set Aztor Lacat i em and Ler p 
to interpolate between the current location and the destination. 
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See also 


= Chapter 5, Handling Events and Delegates, has a number of recipes relating to the 


spanning of actors 


nts that can b 





Another way that C++ can be more tightiyintegrated with Blueprint is the creation of functions 
that can have Blueprint implementations in native code. This allows for a programmer to 
Specify an event, and invoke it, without needing to know anything about the implementation: 
The cas can then be subclassed in Blueprint, and another member of the production team 
can implement a handier for the event without ever having to go near a line of C++: 


How to do it.. 


1. Createanenstat 





leshactar class called Spotter 


2. Make sure the foloaing functions are delned and overridden in the dass header 


virtual vold Tick float Deltaseconds | override; 
ÜFINCTI OM Bi vepri nti mpl ement al eEvent) 
veld OnPlayerSpotted(APawa” Player) 





3. Add this code to the constructor 
Primaryactarti ci 
ConstructorHel pers: : FObj ect Fi nder <UStat i cles» 
CREATI Statiemeah engine! aes! eShops 
1t (Neshasset-Objert t= nuliptri 
t 

set Stati cHeshtaponent (1 
set Stati chest esbisset, Obj ect] 
Get Stati eNeshConponent | >bGenerate0verl apEvents = t 
] 
Getstati chest Componenti 
>Set Mobility Component Nabi |i ty: Movable) 
Get Stati cMeshConponent |)->SetRel ati vekotati onl 
Ta 

















m 
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‘bd this to heck function: 
Supers: Tek DeltaTine 


auto EndLocation = GetcterLacatls|) + 
Actor taar |. Transtorbecter(Fvester(9, 0, 209) 
Palthesule Mi these 

Gera snecgSiagetychanel ttes 

Eit Camera, rca sianshape: Nakespheral 251 

FG lalonQueryParame Spats, true, thia] 

Mie! Spotteahl ayer = Ceet<iPawn>( Hi terit Actor Get] 














[spotted ayer!= null ger) 





iul ayer spot tedi Spot tedPlayer] 
Brsebetugt inel Get or). Gethctertoratlenl], EnéLacati on, 


Compile and start the editor: Find yourSpat er class in Content Browser, then left- 
lek and drag a copy out into the game werd 

When you play the level, ju see the red Ine showing the trace thatthe ct or 

i performing However, nothing will appen, because we havent implemented our 
iPlayer Spotted event 

"n order to implement this event, we need to create a blueprint subclass of our 
Spotter 

Right click onSpet ter in Content Browser, and select Create Blueprint class 
based on Spotter, Name the class 3PSpat ter 
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3. Inside the Blueprint editor, cick on the Override button in the Functions section of 
the My Blueprint panet: 





1. Lefttick and drag trom the white execution pin on our event. In the context menu 
tat appears, selectand adda Pr i nt String nade so that itis linked to the event 





a] Pia 


> 
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12. Playthe level again, and vet that walking in front af the trace that the Spet ter is 
using now prints a string to the screen 





1. Inthe constructor for our spot t er object, we load ane af the basic primitives, 
cone, into our Statie Mesh Component as a visual representation. 

2 We then ratate the cone so that it resembles a spotlight pointing to the X axs of the 
ador 

3. DuringtheT ck function, we get the actors location, and thon rd a pont 200 units 
away ram the actor along its oca! X anis. We eal te parent class Implementation of 
Tick usingSuper: to ensure that any ather tick functionalty s preserved despite 

4. We convert a local position into a world space postion by rst acquiring the Atorto- 
Word transform forthe act or , then using that to transform a vector specifying the 

5. The transform is based on the orientation of the root component, which is the static 
mesh component that we rotated during the constructor. 

5. Ae a result of that esting rotation, we need to rotate the vector we want to transform: 
Given that we want the vector to paint out of what was the bottom of the cone, we 
wanta distance along the negative up ais, that is, we want a vector of the form (0.0, 
i where dis the actual distance away 

T. Having calculated our end location for our trace, we actually perform the trace with 
MeSweepsi ngl eby Channel function. 

B. Once the sweep is performed, we try to cast the resulting hit Act or into pawn, 





9. Ifthe cast was successful, me invoke our implementable Event of 
np] ayer Spot ted, and the userdebned Blueprint code ee tes. 
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Multicast delegates are a reat way to broadcast an event to multiple objects who listen or 
subscribe to the event in question. They are particularly invaluable if you have a C++ module 
‘hat generates everts that potential arbitrary Actors right vant to be noted about. Tris 
recipe shows you how to create a multicast delegate in C++ that can notify a group of other 
Actors during runtime. 


How to do it... 


1. Create neu stati cles actor class called Ki ng. Add the following to the class 
header 
DECLARE OYNANI C, ULTI CAST. DELEGATE, OneParaml Fs ng 
Desthsi nature, Aking”, Disdki eg 


2. Add a new UF UNCTI ON to the class: 


UFUNCTIOM B uepri attal lable, Category = King 
ved ae 


3. Add an instance of our multicast delegate to the class: 
UPROPERTYI BI vepri ot Assignable) 
Foni ngDeathSi gratare Onk:ngbeath 


4. Add our mesh initialization to the constructor: 
Constructor Hel pers: : FOb] ect Fi nder <UStat |cesh>| TEXTI “St tl 
flesh’) Eng ne Besi Shapes) Cone Cong 1 
1 (Meshasset. bj ect te nal pte] 

( 
Getstati ceshtomponent (1 
Ssetitatr Mesh esset. Obj ect) 
Get Stati eMeshComponent(|-obGenerat eOver|apévents 
] 
Getstaticueshconpenent| 
See Mobil Ly Component Mobil ty: Movable) 








5. Implement thei e function: 
t 
Onki ngoeath. Broadcast (this 
' 








6, Create anew clas called Peasant, also based on Stat i cNeshAct or 
T. Declare a default constructor in the class: 
ansam 


3. Declare the folowing function: 


UFUNCTIOM i vepri etal able, category = Peasant) 
vai Fleet axing! Deadri ngl 


9. Implement the constructor: 
auto Meshasset = 
Canstructarkel pares: Fb] ectFl der clstati testo TENTI "Stati e 
Neth" | Engine asl eshapes/ cube Cube" ^1) 
1E Deshisset. bj ect te nulipti 


Get staticMeshcomponent(| 

SS Stati Olesh MeshAsset. DU] ect] 

Get tati cMeshComponent(|->bGenerat eQverlapévents = true 
ï 


Getstaticueshconpenent| 
>Set Mobility Component Mobility: Movable) 


10. implement the function inthe. cp He: 
veld APeseant Fle AKI ng? Deadkingl 
t 
Engi ne- »AddOnScreenDebughessagel-1, 2, FColor:: Aed, 
TERI p Waly! I) 
Factor FlasVecter = Getactarlocatioe|) - Dedki ag 
Séatlevertacst ent) 


Hleetector Normal izel) 
Flesvector "= $86 

SetActarLocati anl GetActerLecation|) + Fleevector) 
1 


11. Open Blueprint and create a Blueprint class based on APeasaat called a? Peasant 








a 
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12. Within the blueprint. cick and drag away rom the white execution) pin of your 
Eegi nPI ay node. Type get a11 , and you should see Get All Actors OF Clas. 
Select the node to place itin your graph. 





13. Set the value of the purple (class) node to Ki ng. You can peti ng inthe search bar 
ta make locating the class in the list easier, 
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14. Drag from the blue grid (object array} nade out into empty space and place a get node, 


15. Drag away from the blue output pin of he get node, and place a Not Equal 
(objet node 


16. Connect the red (hool) pin of the Not Equal node to a 8r anch node, and wire the 
emeton pinot ranch oourGst All Actors Of CI ass mode. 
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37, Connect the True pin of the branch tn the Bind Event to Onking Death nade 





FC Note that you wil probably have to untick Context Sensitive nthe contet 
menu forie Bind Event node ta be visis 


18. Drag out the red pin on the Bind Event node, and select Add Custom Event.. in the 
contest menu which appears after you release your left mouse buton. 
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19. Give your event a name, then connect the white execution pin ta anew node 
named? lee 








20. \Vesifythat your Blueprint looks like the following are: 








71. Draga copy af yourk ng las into the level, then add a few BP Peasant instances 


around tin cel, 
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22. Open the level Blueprint. Inside t, drag away from Begi 


Pay, and adda Delay 
node, Set the delayto 5 seconds. 


23. With your Ki ng instance selected in the level. rightclick inthe graph edltor forthe 
Leve! Blueprint- 


Select Call function on King 2, and look in the Ki ng category for a function 
called Di e. 
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26. When you play your level, you should see that the king des after seconds, and the 


peasants ali vail and jee directly amay fromthe king. 














How it works 


1 


We create a new actor based on St at | cMeshAct or for convenience, as it saves 
us having to declare or create a Statie Mesh component forthe Az t or Visual 
representation) 

We declare a dynamic multicast delegate using the DECLARE DYNAM C, 

MULTI CAST_DELEGATE_OnePar am macro. Dynamic multicast delegats allow an 
atbivary ruihber of objets to subscribe (sen) and unsubscribe (stop Istening) so 
that they al be noted when the delegate is broadcast. 

The macro takes a number of arguments-the type name of the new delegate 
signature being created, te type of the signatures parameter, then the name 
the signatures parameter. 

We also add a function to Ki ng that wil allow us to tellit to die. Because 

we want to expose the function to Blueprints for prototyping, we mark it as 
Bruepri nt callable 

The DECLARE, DYNAMIC. MILT CAST, DELEGATE macro that we used earlier only 
declared a type: it didnt decre an Instance of the delegate, so we go that now 
referencing the type name that we provided earlier when invoking the macro. 
Dynamic multicast delegates can be marked ver i nt Assi gna b! e in their 
UFAOPERTY declaration. This indicates to Unreal that the Blueprint system can 


dynamically assign events to the delegate that will be called when the delegates 
Sreadeast function is called! 





m- 
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D 


n. 


Je always, we assign a simple mesh to our Ci ng so that it has a visual representation 
inthe game scene. 


Within the Di e function, we caller oadzast. onouranndelegte We specie that 
the delegate would have a parameter that is a pointer to the king which died, so we 
pass this pointer as a parameter to the broadcast function. 


Uyon wae ting bedside han loan animan 
Sane aac ids dnd age be 
isis secs and as trade spe for eae, 
outa selector siglas alin 

(eden aed oda be beans tu ee 

SÉ oram, 

Wie ou peal oul tave a statin rhe. 
roris aene cae Due c. 
Atte oso ats loe pr dun 
EAD, 


Within curnetStati cMeshAct er subclass, calledPeasant , we initialize the 
static mesh component as usual using, a different shape to the one that we used 

for the Kin 

Inside the implementation af the peasants ee function, we simulate the peasants 
playing sound by printing a message onthe screen. 

ethen calasate a vector to make the peasants jee by brst Ending vector fromthe 
‘ead king n this peasant’ location. 

We normalize the vector to retrieve a urit vector (with a length of 1) pointing 

in the same deecton. 

Scaling the normalized vector and adding it to our curent location calculates 

a positon ata oed tance, in the exact recon fer the peasant to be yeang 
rect anay rom the dead king. 


Set Actor Location is then used to actually teleport the peasants to that location. 


Myou used a Character with an A controller, yow could have the Peasant 

é pathfind to the target locaton rather than teieporting, Ateatively ou 
Eoul usea Ler p funcion med during the peasants T1 ch to make 
them stide smoothly rather than jump directo the location: 


Lock at Chapter 4, Actors and Components, far more extended discussions about 
Actors and Components. Chapter 5, Handing Evens and Delegates, dicusses 
events suchas oti fy Act ar Overlap. 
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nums that can 





Enums are conroniyused in C+as ags or inputs to switch statements. However, what if 
ou want to pass an enu = velue to or from C+ froma Blueprint? Altematiey if you wart 
to use asni tch statement in Blueprint that uses an enu m from Cer, how do you let the 
Blueprint editor know that your enum shouid be accessible within the editor? This recipe. 
shows you how to make enums visible in Blueprint. 


How to do it.. 


1. Create anew stati cWeshActor class called Tr ee using the editor 
2. Insrtthe following code above the class declaration: 


UEM B vepri at Type 


t 
Tree spruce 





I 


3. Add the folowing UPROPERTY in ther ce class: 
Térantsiyt eetresTypeo Type 


4. Add the folowing to the Tree constructor: 
Constructor el pers: : FObj ect Fi nder distat i cesho| TEKTI “St tl 
Wei | Engine Basi Shapes) Cyl inder Cylinder 1 
1 Deshisset. Db ect te nal pte] 

( 
set Stati cHeshComponent (] 
set Stati chesh{ Mestasset. Obj ect] 
Get Stati ceshComponent (1+ >bGenerate0verl apEvents = true 
] 
GetStati lesh componenti 
set uobi Li Component Mobil ty: 

















S. Create a new Blueprint class, called WTr ee, based on Tree 
6. Inside the blueprint editor far My Tr ee , click on the Construction Script tab. 





m} 
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LL Rightclick in the empty window, and type tr ety pe. There is a Get numberof 
entries in TreeType node. 





8, Place, and then connect its output pin to a Random Integer node. 





3. Connect the output ofthe random integer to a Tt e node. 
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10. in the Variables section of the Blueprint panel, expand Tre and select Type. 





1L. Drag this ito the graph, and select Set when you see a small contest menu 
appear, 

12. Connect the output of le To jte node to the input of the SET Type node. You see 
‘an ena conversion node automaticaly appear. 





13. Lastly connect the eecutlon pin of Construction Seript to the SET Type node's 


ecu pin. 





gu- 
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24. Your Blueprint should look ie the fllowing: 





15. To very thatthe blueprint is correct functioning and randomiy assigning a 
pela our ee, we are gong o add some nodes tothe Event Graph 


16, Place afrint String node after the Event Begin?lay event node. 





17. Placeaformat Test node, and connect ts output tothe int ofthe Pr 
String node. conversion nade wil be added for you, 








Chapter 





18. Inside the Fer mat Text nade, add MyType is tothe textbox 





19. Drag Ty fom the variables section of he Blueprint into the graph selecting Get 
from the menu, 





20. Add an Enum to Name nade to Type output pin 
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21. Connect the Name output to the input pin on Far mat Text labelled 0. 





22. Your Event Graph should now look like the following: 





23. Draga few copies af your Blueprint inta the level and hit Play You should see a 
number of trees printing information regarding their tpe, verling that pes are 
being randomly assigned by the Blueprint code that we created. 





How it works 


1. A usual, Meuse St ati eMeshAct or as the base class forourAct or sa thatwe can 
‘easly he Ica sual representation inthe level. 


2. Enumerated types are posed to the rejection system using he ENUN macro. 
3, Wemarkthe enum as Blueprintavailable using the BI uepr i nt Typ spece, 
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The enum declaration is just the same as we would use in any other contet 
QurTr ee requires a Tr eeTy pe. Because tree has tree-type is the 
relationship we want to embody, we incude an instance of TreeType in our Tr ee 
dass 

‘As usual, we need to use UPROPERTY(| to make the member variable 

accessit to the rejection system. 

We use the BI sepri nt Rea diiri te speciperto mark the propertyas having 

both get and set support within Blueprint 

Enumerated types require being wrapped in the TEn uss Byt e template when used 
in PROPERTY, so we declare an instance of TEnumAs Byt e £TreeT] pe» asthe 
Trees Type variable. 

The constructor changes for Tr ee are simply the standard load and initialize 

‘ur static mesh component preamble used in other recipes. 

We create a Blueprint that inherits from our Tr ee class so that we can 
demonstrate the Blueprintaccessibiltyof the T1 2eT9pe enum 

In order to have the Blueprint assign a type to the tree at random when we 

‘create an instance, we need to use the Blueprint Construction Script. 

Within the Construction Script, we calculate the number of entries in the 
TreeType enum. 

We generate a random number, and use that as an indexin the TreeType 

enum pe to retrieve a value o store as our Tyge. 

The Random number node, however, returns integers. Enumerated types are 
treated as bytes in Blueprint, so me need to use a Toy» node, which can then be 
implicitly converted by Blueprint into an e nu m value. 

Now that we have Construction Script assigning a type to our tree instances as they 
are created, we need to display tne tree's type at runtime. 

We doso with the graph attached to the Begi n? ay event within the Event 

Graph tab. 


To display test on screen, weusea Print String node. 


To perform string substitution and print our type out as a human-eadable 
slong, we use the Far eat Tert node. 


‘TheFer mat. Text node takes terms enclosed in curly braces, and allows 
you tosubstt te other values for hose ters retuming the ial string. 


To substitute our Type into the Far mat Text node, we need to convert our 
‘variable stores fom the sr um value nto the actual name ofthe vale 


We can do so by accessing ourTy pe variable, then usingthe Exum to ane node. 
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22. Nane, orF Mames in native code, are a type of variabile that can be converted to 
stince by Blueprint, so we can connect our Name tothe input on the For mat Text 
node 


23. When we hit play, the graph executes retrieving the pe of tree instances placed in 
the level, and printing the names to the scree, 


Editing cla in dif 


in the editor 





When developing wih Unreal, itis common for programmers to implement properties on 
‘Actors or other objects in C+, and make them visible to the editor for designer use. However, 
‘Sometimes it makes sense to view a property or to make it editable, but oniy on the objects. 
‘elaut state. Sometimes the property shoud oniy be mocipable at rune wth the defaut 
Specbed in Crt: Fortunately there are some specipers that can help us restrict hena. 
propertyis available. 


How to do it.. 


1. Create a nen Act or class in the editor caled Propert ySpeci ti er Act 0 


2. Add the flowing property debritions tothe clas: 
UHRCPERTH Edi t Defaut t son I 
hen edit ef aul tsonty, 
ÜMROPERTY Edi nse anceon! yl 
bool Editi nstancedn'y 
UPROPERTY| Edi Loy mer. 
bool editanywnere 
UPROPERTY| Vs bl ebefacl ten y) 
bool Visi el eDefau tse y 
bool Visiblelnstanceoniy 
UPROPERTY Vi s! bI eAnyuter e) 























3. Compile your code and launch the editor. 
4. Create a new blueprint based on the class. 
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S. Open the blueprint, and look at the Class Defaults section. 





6. Note which properties are editable and visible. 





X. Place instances in the level, and view their Details panels. 


Å. CES 





3. Note that a dierent set of properties are editable. 
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1. When specifying PROPERTY, we can indicate where we want that value to be 
available inside the Unreal editor. 

2, Vi sibl e* prebes indicate that the value is viewable inthe Details panel for the 
indicated object. The value wont be editable, hoever. 

3. This doesnt mean that the variable is a const qualiper; however, native code can 
change the value, for instance. 

4. Esi t» prepes indicate that the property can be altered within the Details 
panels inside the editor. 

5. InstanceOn! y asasupindcates that the property il oniybe displayed inthe 
Details paneis or instances of your class that have been paced into the game. They 
won't be sible in the Class Defaults section of the Blueprint editor, for example 

6. Default sOn! y is the inverse of! nstanceOn! y—UPROPERTY will only display in 
the Class Defaults section, and can't be viewed on indhidual instances within the 
leve. 

T. Thesulfainy where is the combination of the two previous sufpesňithe UP ROP: 
wil be visible in al! Details panels that inspect either the objects defaults or a 
particular instance in the level, 


See also 


* hs recipe makes the property in question visible in the inspector but doesnt allow 
the propertyto be referenced in the actual Blueprint Event Graph. See the next recipe 
for a description of how to make that possible. 





operties accessible in the 


print editor 





The specs mentioned in the prevous recipe are ail well and good, but they only corse 
the visiblity of UPROPERTY in the Details panel, By defaut, even with those specipers used 
appropriately, UPROPERTY wont be viewable or accessible in the actual editor graph for use 
2t runtime. 


Other specipers, which can optionally be used in conjunction with the ones in the previous 
recipe, can be used to allow interacting with properties in the Event Graph. 





Chapters 





How to do it. 


1. Greateanen Actor clas called I sepri nt Propert yactor using the ditor 
ard 

2. Add the folowing UPROPERTY tothe actor using Visual studi: 
UPROPENTY|Bluepristeadwrite, Category = Cookbook) 
ios KeadiriteProperty 
UHOHERTY Bi vepri atieadony, Category 
boni Mastün yProperty: 











3. Compile your project, and start the editor 
4 Create a Blueprint class based on yourél vepr i nt Propert yhctor, and 
open ts graph: 


5. Verltythat the properties are vile under the category Cookbook In the Variables 
section of he My Blueprint pane 





5, Leftclick and drag the Read property into the event graph, and select Get 


7. Repeat the previous step selecting Set 
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3. Dragthe ReadOnly propertyinto the graph, and note hat the Set node is disabled. 


4, Blueprint Reaeitri te as a UPROPERTY specier indicates to the Urea Header 
Tool that the property shoul have bath Get and Set operations exposed Tor use in 
Blueprints, 

2. Blueprint ReadOnly is, asthe name implies, a speciper that oniy allons Blueprint 
to retrieve the value of the property never set it. 

3. Blueprint Reaon!y can be useful when a propertyis set by native code, 
but shouldbe accessible mithin Blueprint 

4, thshould be noted hal vepri nt Reade it andal vepri nt Reagan! y dont 
“specify anything about the property being accessible in the Details panels or the My 
Blueprint section af the edtorithese specipes oniy control the generation of the 
eter setter nodes for use in Blueprint graphs. 





editor 





Whena designer changes the properties of an ictor placed in the level, itis often important 
to show any sual resus of that change immediately rather han just when the level i 
Simulated or played. 


When changes are made using the Details panels, there's a special event that the editor 
emits called Post Edi t Change Pr oper t y, which gies the class instance a chance to 
respond to the property being edited. 


This recipe shows you how to handie Post Edi t ChangePr oper t y for inmediate inedior 
feedback 








1. Create anew Act or called Post Edi tChangePropertyäctor based on 
Stati elleshActar 


2. Add the folowing UPROPERTY to the class: 


PROPERTY| Esl Anger el 
bool. Showstat: teen 


3. Ad the fling function depnition: 


virtual void PostëditChangePropertyl FPropertyChangedEvent t 
PrapertyChangedvent) aver tide 


4. Add the following to the class constructor: 
auto Meshasset = 
Canstructarhel pares: Fob) ectFi nger <UStat i cNesha[ TEXTI "Stati e 
Neth" | Engine asl shapes) Cone. Cone’): 
1 Dshisset. Db ect t= nulipti 
t 
Getstati ceshtonponent (1 
Set ati Mesh Mes eset. DU] ect) 
Get tati cMeshComponent(|->bGenerat eQverlapévents = true 
] 
Getstati eshCompenent |) 
SSe Mobi t yl Component Nabi |i ty: Movable) 
Shestiti cerne true 


5. Implement?ostE6it ChangePropert y: 
veld 
Arist edit changeprapertyActor:=Past Edi t changeFrapertylFPrope 
Ftychangeatvesté Propertychengedevent) 
t 
Lf [Prapertythangedtvent. Property t= nuli ptr) 
1 
canst Phase PropertyNane( Propert yChangedevent. Property 
Stam): 
1E Property 
GET_NENBER NAME CHECKEDI Abest £I Ch angePropert ictor 
Showse ati evesaly 











et Stat ichashCamponest() le auli ptr) 


Getstaticuesnconpenent (| 
Sservieieiiveyignewseatiefesh) 





n 
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, 


Super: Post dl (ChangePraperty Property Changedtvest) 
i 
6, Compile your code, and launch the editor. 


7. Dragan instance of your class into the game word, and verify that togging the 
boolean value forSheust at i c Mesa toggles the vst ofthe mesh in the 
editor viewport. 
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1. We create a nen Act or based on Stati cNeshact or for easyaccess to a sual 
representation via the Static Mesh. 


2. UPROPERTY is added to give us a propertyto change, to cause 
Postedi t ChangePr oper t'y events to be triggered 


3. PostEdi tChangePr oper ty is avirtual function denedin 
4. As a result, we override the 








nction in our class. 


5, Within our class constructor, we initialize our mesh as usual, and set the 
delautstate of curo! property to match the visibiity of the component it controls. 


Inside Past Edi t Change Pr oper t y, we prst check that the propertyis valid. 
Assuming itis, we retrieve the name of the property using Get F aee 
Flares are stored internally by the engine as a table af unique values. 


Nest we need to use the GET_ MEMBER, NAME, CHECKED macro. The macro 

takes a number of parameters. 

10. The rst one is the name af the dass to check. 

11. The second parameter is the property to check the class for, 

12. The macro wil, at compiletime, very that the cass contains the member 
specited byrame. 

23. We compare the class member name that the macro retums against the 
name that our property contains. 


14. If they are the same, then we verfythatcurSt at i cMesh Component is 
intialzed corecty 


15. If itis, we set its visibility to match the value of our ShowSt ati cesh Boolean. 





Implementing a native code Construction 


Script 





Within Bluegeint, Construction Scriptis an event graph that runs any time a property is 
changed on the objecti is attached to-ahethe from being dragged In the editor viewport 
or changed va direct entry in a Detalls pane 


Construction seripts allow the object in question to ebuild" sif based on its new location, 
for instance, orto change the components it contains based on userselected options. 


When coding in C++ with Unreal Engine, the equivalent conceptis theOnConst recti en 
function. 
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1. Createanewactor called AOnConstructi anAct or based on 
Stati elleshkctar 

2. Add the folowing UPROPERTY to the class: 
UHROHERTY Edi Any merel 
baal Shovitati Mesh 

3. Add the fling function depnition: 


virtual void Ontonstrotti en coast Flrasstornk Transformi 





4. Add the folowing to the class constructor: 
auto Meshasset = 
Canstructarhel pares: Fb] ect nger <UStat i cNesha[ TEXTI "Stati e 
Nash | Engine basi cShapes Cone Cane” =h) 
1E (Neshasset-Objert te nulipti 
t 


set Stati cHeshCamponent (1 
Sset Stati lesh Mes eset. DU] ect] 


Get Stati cHeshComponent (1->bGenerate0veri apEvents = true 
] 

Getstati cMeshtonpenenti) 

>5et Mobi I itl Component Nabi |i ty: Movable) 

Snoestatl eves = true 


5. Implementoncenstructi on: 


veld Aancensteuctiondctor::oncensteucton( const FTeanst orm 
Teanst orm) 


Get Stati cMeshComponent()->Set¥isi bil tyl ShouStati cest) 
: 


6. Compile your code, and launch the editor. 


7. Dragan instance of your class into the game world, and verify that togging 
"he Boolean value for Shows: at i cles toggles the visibiity of the mesh in 
the editor viewport. 
B. OnConst recti on does not curentlyun for C++ actors placed in a level if 
they are moved. 
9. To test this, place a breakpoint inyourOaCenst ruet i en function, then move your 
actor around the level, 
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To piace a breakpoint place your cursor on the desired 
Ine, and Fa in Visual Studia 


10. You'l notice that the function doesn't get called, but if you toggle the 
ShowStats ces? Boolean, itdoes, causing your breakpoint to roger. 


In orderto see why takea look atMct or :: Post Edi t Move 
Uslueprint® Blueprint = Cast eUB uepri er» Get CL aes] 
tlasstererateaty) 
ital esprit (Blueprint 
Sehuncenst uct onsceigtOndrag || Fini shed} 
[rre 








t 
| aneeca( caters at 
Merestosttratleriertps] 
' 


The top ine here casts UCI ses for the curent object ta UB uepri nt, and 
wil aniy run the construction scripts and QnCanstruct ian again the 
Classis a Blueprint. 


How it wo 


1, We create a nen Actor based on St ati eMestAct or foreasyaccess to a vata 
representation via the Static Mesh. 


2. UPROPERTY is added to give us a property to change-to cause 
Posted tChangePraperty events to be triggered 

3, OnConst recti en isa tua function deþnediin Acor, 

4. As a result, we override the function in our class, 

5. Within our class constructor, we initialize our mesh as usual, and set the default state 
Gf eur! property to match the viia the component that it conros 

5, Inside OnCoast r ucti on, the actar rebuilds itself using any properties that are 
required tor doing so. 

X. Far this simple example, we set the visibility he mesh to match the value 
fof ourShewSt ati cech property. 


B. This could also be extended to changing other values based on the value of the 
Shastati chez? variable 








mj 


Integrating C+ andthe Unreal Editor 
9, Youli note that we dont ect hter on a particular property being changed ike the 
previous recipe does with Post Edi ChangeProperty 
10. The OnConst r uct i on script runs in its entirety for every property that gets 
changed on the objec. 
11. It has no way of testing mhich property mas just edited, so you need to be judicious 
about placing computationally intensive code within t 
dule 


Cr edit 





m 





ngan 


The folenin recipes all interact with edtor mode specie code and engne modes, As a 
result, itis considered good practice to create a new module that wil only be loaded when 
Me engine is running in editor mode s that we can place all our edtr-onycode inside 1t 


1. Open your projects. spraj ect Hein a tet edtor such as Notepad or Notepad: 
2. Add the bolded section of the faloningto the He: 
( 
jAtenorpt * 
} 


“Namet: ‘uE¢caoubeae’ 
es "Runtime", 

additi onal Dependencies": | 
Engl se! 

"Grut ect 














n 

t 

“pamet: SueAcookbookEdi tor", 

Tee: Editar", 

zb ngPhase” 

"Malt onal Depi 
inte, 
"Grut ect 

1 

, 





sing net alts 
eneen: d 
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3. Note the comma after the st module before the second set of curly braces. 


4. In your source feider, create a new folder using the same name as you speciped in 
yourupra] ect He(intisinstance, UEt Cookbook Edit or") 


5. Inside this new folder, create fe called UE Cesk bockEGit or. Bui 1. s. 
5. Insert the followingirt the He: 


using Unreal Buil dTool 


public class UEUCookbookëditor : Noduletules 


t 
public UEaCaokbookëdi tor |Targetiato Target) 
I 
Pabi icDependencyNadul eNames. AddRangelnew string] ( 
Score’, feoreuoaj ect", “Engine”, "inputCore", SAM 
hendertore", "Shader ore) 
Publi eDependencyNedul cames. Mal t tCoetboot") 
Privat ebependency ou! ekanes. AadRange(aew strl agi] { 
“Unreal ee" 3) 
D 
i 


7. CeateanewțecalleduEtCookbookEdi tor. h and add the following: 


toragm once 
finci ude "Engi ne. t 
finci sde “Modal eanager. N 
finci ede “Unreal Ets 


class FütitontbontEdi torNodule: public INodulelntertace 
t 
D 


B. Laty.ceatea newsource He calledut 4 Coot bookEdi tor. cop 


9. Add the folowing code: 
#i ncl ade *UEdCookbookEdi tor. h" 
IMPLEMENT GAME. NODULEL FUEACookbookëdi tar Modul e, 
[repe 


10. Fal close Visual Studio if you have it apen, on right click on the. upra] ect He, 
and select Generate Val Studio Project bles 
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11. You should see a mal window launch, display a progress bar and then cse, 


32. You can now launch Visual Studio, very that your new module i visile In 
"Be IDE, and compile your project successu. 


13. The module is now ready for the next set of recipes. 


Cade changes made in this editor module wont support hatreloading 
<n the same way that code in runtime modules does I you peta 
Se campiotionerar that mentions changes to generated header Tes, 
Simply close the editar, and reas frm within your IDE lend 


How it works. 





‘Unreal projects use the_upr ej ect He format to specifya number of different 
pieces of information about the project 


2, This information ie usedi to inform the Header and Bui tools about: the modules that 
comprise this project, and is used for code generation and sate |e creation. 


3. The þle uses JSON-<tyle formatting. 
4. These include the folowing: 
© The engine version that the project should be opened in 
«o Alistof modules that are used in the project 
E Alstof module declarations 


5, Each of these module declarations contain the folowing: 
© The name ofthe module, 

© The type of the module-s an editor meduie (only runs in editor builds, has 
access to edtoraniy classes) or a Runtime module funs In both editor and 
Shipping bulls) 

«— The loading phase of the module-modules can be loaded at diferent points 
during program startup. This value species the point at which the module 
shouid be loaded, for example, there are dependencies in ather modules 
that should be loaded fist. 


© Alstaf dependencies forthe module. These are essential modules that 
contain exported functions or classes that the module relies on. 
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ES 


E 
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20. 


E 


22. 


We ad a new module totheuprs| ect. file. The modules name is 
UdCaekbootEsi tor (conventionally, Edi tor should be appended to the main 
game module foran editor module). 

This module is marked as an editor module, and is set to load after the 

baseline engine so that it can use the classes declared in Engin code. 


Our module's dependencies are left at the defaut values for now. 


With the upr ect Healteredto contain our new module, we need a bul 
seit fort 

Build scripts are written in C& and take the name cedat eame», Build 

CH unlike C+, doesnt use separate header He nd implementations all there 
inthe one. cr Be. 

We want to acces the classes declared inthe Uar eal Bui | éToo! module, 
soweincludeausing statement to indicate that we want to acess that namespace. 
We create a publ i c cass with the same name as our module, and which 

inherits rom Wed ef es. 

inside our constructor, we add a number of modules to the dependencies of 

this module 

There are both private dependencies and public dependencies. according to the code 
ofthe Nogu! ežu es class, Public dependences are modules that your module's 
Public header Hes depend on. Private dependencies are modules that the prhate 
‘ode depends on. Anything used in boh public headers and private code should go 
into the Publ i eDependencyModul eames array 

‘oul note that ourPub! i cDependency Madu! elames array contains our main 
game module. This is because some recipes in this chapter wil extend the editor to 
better support the classes deped within cur main garre module. 

"Now that weve told the build system that we have a new module to build through the 
project He, and væve specibod howto build the module with the build script, ve need 
to create the Ces class that is our actual module. 

We create a header pethat indudes the Engne header heo dul ea ager header, 
and the Uar ea! Ed header. 

We include Modul cNanager becauseit depnesi Modu! e at er face, the class that 
out module wil nhert om. 

We also include Uar ea! 4 because weve witing an editor module that wil need 

to access the editor functionally 

The class we declare inherits from! Modul el at er tace, and takes its name from 
the usual prec f. fooned by the module name. 

Inside the. cop He, ve include cur module's header, and then use the 

IMPLEMENT. GAME- MODULE macro. 
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23. WPLENENT_GAME_MOQULE declares an exported C function, 
[tat 22Madul et), which returns an instance of our new module cass. 

24. This means that Unreal can simply call ni ti al i zeWodui el) on any bray that 
exports itto retrieve a reference to the actual module implementation without 
needing to know what class it's. 

25. Having added our new module, we now need to rebuild our Visual Studio solution, so 
we close Visual Studo and then regenerate the project Hes using the corto menu. 


26. With the project rebuilt, the new module will be visible in Visual Studio, and we can 
add code to It as usual. 


eating new toolbar buttons 


1 you have created a custom tol or window for display within the editor, you probably need 
Some way to let the user make it appear. The easiest way to do this ls to create a toolbar 
Customization that adds a new toolbar button, and have display your window when clicked 


‘Create a new engine module by following the previous recipe, as we'l need itto initialize our 
eobar customization, 


How to do it. 


1. Create a new header þle, and insert the flowing dass declaration: 
toragm once 
nel ade “Commands. ht 
finci ade "EA tor Styl eset. a" 


class FCookbeekConmangs : publi 
Teanmands Cost bost Comment? 
( 


Feaatbostconmanse() 

Tüenses i CookbootCommands> 

jflarel TEXTI "UEA. Costbost]) 

Hari Framstriag{"Ceataeek Commands“ |, WE. Mone 
Fedlterstyla:. Gest eset Name ]] 

1 


) 
Virtus val RegisterCommands|) override: 





TéharedPt rel commandi nt o> myeuteen 








Implement the new las by placing the following in the. cpe Be: 
#i ncl ade *UEdCookbookEditor. h" 

#i nci ede “Commands. A" 

tcl ede “Cookbook Commands. h" 


vaid Ftostbostonsinds: : Regi sterCommands() 
( 
#det ine Locteat_nanesrace * 
dI COMUARD( MyButton, “Costbost*, “Demo Cookbook Tool tar 
Comand", eUterintarfacehct entyse: Button, 
HapuGesturel} 
undef LOCTENT_MANESPACE 
, 


Bá the following within your module class: 
virtual void Startuphodulel override; 
virtual vaid ShutdownModulel) override 
Tsharedhtr<FEstenaer> Tool barestenser 
TsharedPtrecoost FExtensionBase> Extensl en 
void syduttan_clicke 
t 
Téharedief SM ndow> Cookbook dew = Stew! SM ndol 
We le(#Teat:: Fronstri ngl TEXTI "Cookbook Window") 
Client size|Fvector20(480, 400)) 
Susportshaxi mi ze( Fal sel 
SupporesW aim rel al sel 








| Nai nraneNadul eb Nai nFraneodul e 
Fast! eianager:LoadhoduleCheckae Mal nFr ameliodul e> 
TEXTU Mal frame) 





if (Wal aFramenosul e Get Parent nét aL £1) 


' 
Félateipplicat on: Get] Add adowAshativechll ¢ 
(Cookbook aden, Nai aFraneNadul e. Get Parent W ndol) 
Fasnaredaet | 

) 

E 

i 


FSiateappl ication: Get] AGAW adowl Cookbook M ndow); 
D 

k 

Vaid AddTasl barēxtension(#Tool BarBuil der Gould der) 


( 





a 
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Fslatelcen Iconrush = 
Eslatel con FEM erst ye: Get Styl eset tamel | 
‘Level téttor Vi ewdpt I ons" 

‘Level Edi tor. Vi ewOpt i ons. al^) 


bui i der. Tesi Bar Bett s] Cost bool Commands: Get (1 
yautten, MAME None, FText::Fromstri ngl My sutton"), 
Hent: sPronstriāgl Click me to display a message"! 
IconBrush, NANE. Hone} 

n 


4. Besureto ži nc use thebeader He for your command cass as wel 
5, We now need to implement St art upMedul¢ and Shut downlode! e 
veld FUEACookbookēdi tor Modal e: Startup adul e) 
( 
Feoatbostconmanst: Regi stert] 
TsharedPtr «FUI Cammaadkist> Cenmaralist = 
Makashareabi elnew FUI Command ist] 
Cammandtist-9Napketen(CeakeeokCenmands:: Get |). yaut ton: 
Fexecuteact ion: Createham thus 
SFUEUCustbostea tor Modul e:: MyButt on_CI i ced) 
Feastvecutedct lan ]] 
Tool bartender = WateSnareatl e( ew FExtender|}) 
Extension = Toni taret ender 
>Addtoal BarExtensi on Compile", EExtensi onMook: : Before, 
Commandtist, Faol BarExtensi anel egate: Creat eham this 
EFUECCastbaateai tor Mogul e: adaTaal bar Extensi on]) 





Level eai tor Modal ed Level Edi tor Nodul e 
Padi everager. LeadModal eCheckesefLevsl Edi tar Nodul e> 
Mtera Editar"); 

Level Edi tor Modul e. GetToal BarExtensi bi II tyltanager 
>AddExtender (Tani barExtender| 

i 





Vaid FUEACookbookēdi torModul e: Shut dowaModal ef 1 
t 
Tes tarirt enter 
Shanavetvt ensi anl Extensi on: Tosharedhet (I| 
Entensi an Reset] 
Toal bartender. Reset): 
i 
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‘Ad the following includes: 
acl ade “Level Eedi tor. ht 
nel ade “Slatedasicn t 
nel ede “Mal ti BoxExtende 
inclite “Chapter di Cookbook Commands. h" 





Campile your projet, and start the editor: 


‘Veritythat theres a new button on the toolbar in the main level editor, which can be. 
clicked on to open a new window: 





1 


Unrenls editor Ulis based on the concept of commands. Commands are a design 
Pattern that allows looser coupling between the Ul and the actions that needs to 
perfor, 

In order to create a class that contains a set of commands, itis necessary to inherit 
from TCenmanes 

Ttormarás isa template cass that leverages the Curiously Recurring Template 
Pattern (CRTP)-The CRTP is used commonly throughout Slate Ul code as a means 
‘of creating compile-time polymorphism. 

In the initializer list for F Cook boot Commands constuctr we invoke the 

parent class construct, passing n a number of parameters. 

“The þrst parameters the name of the comand set, andis a simple! Na ne 

The second parameter is a tooltip/ human readable string, and as such, uses 
Fest so it can support localization if necessary. 

M there's a parent group of commands, he third parameter contains the name of the 
group. Otherwise, it contains NAME, Mene 

“The pral parameter for the constructor is the Slate Style set that contains 

any command icons that the command set wil be using. 

The agi ster Comsands(| function allows TComma nës derived classes to create 
any command objects that they require. The resulting F UI Comsandi nf o Instances 
Tetumed trom that function are stared inside he Canan ds cass as members so 
‘that U elements or functions can be bound to the commands. 





a 
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a 


2. 


a. 


z 


This is why we have the member variableTShar edPt r «F UI Command at o> 
MyButton 

In the implementation for the class, we simply need to create our commands 
intei ster Commands. 

The Ul _CONMAND macro used to create an instance of F UI Command! nto 

‘pect a localization namespace to be defied even itis justan empty defauit 
namespace. 

‘As a result, we need to enclose our UI _ CONMAND calls with def i nes to seta valid 
‘alu for LOCTEYT. NAMESPACE even ÎE me dont intend to use localization, 

The actual UI _ CONVAYO macro takes a number of parameters. 

The prst parameters the variable to storethe UI Command! af o in. 

The second parameter is a human eadable name for the command. 

The third parameter is a description for the command, 

‘The fourth parameterisE User Inter taceacti Type. This enumeration 
essentially species wrat sort of button is being created I supports btt 

Toggl butter, Radi out ton, and Check as valid types. 

Buttons are simple generic buttons. A toggle button stores on and off states. 

The radio button is similar to a toggle, but is grouped with other radio buttons, and 
ony one can be enabled at a time. Lasti the checkbox displays a read only checkbox 
adjacent to the button. 

The last parameter for UI _CONMAND is the input chord, or the combination of 

keys required to activate the command 

Tris parameter is prirrarily useful for dering key combinations for hotkeys 
linked to the command in question rather than buttons. As a result, we use an empty 
Input Gesture. 

Se we now have a set of commands, but we havent told the engine we want to 

add the set to the commands that show on the toolbar: We also havent set up 
what actually happens when the button is clicked, In order to do this, we need to 
perform some initialization when our module begins, so we place some code into 
thet art up dul e/Shut own dul e functions. 

Inside tar upModul e, we cathe statie Regi st er function onthe 

commands cass tht we depned earlier. 


We then create a shared pointer to a list of commands using the Makeshar eab! e 
funeon, 





aptera 





z. 


2. 


28 


z. 
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^. 
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ES 
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z. 


Inthe command ist, we use lapā i on to create a mapping, or association, 
between the UI Command nf o object, which we set as a member of the 
FeekteotCemeanés, and the actual function we want to execute when the 
command is invoked. 

‘oul ote that we dont exc set anything regarding what could be used to invoke 
the command here 

To perform this mapping. we call the Na pact i on function. The rst parameter 
toapact ion isa FUI Command! af o object, which we can retrieve fom 
FCookbeotCemands byusing its static Get |) method to retrieve the instance. 

F Cookbook Comsa nés is implemented as a singletons class with a singe instance 
that exists throughout the application. You see the pattern in most places there's a 
static Get |) method available in the engine. 

The second parameter of the NapAc ti on function is a delegate bound to the 
function ta be invoked when the command is executed 

Because UE Cookbonk£di tor Modul e is a raw C++ class rather than a 

os] ect. and we want to invoke a member function rather thana stati £ function, 
we use Creat cham to create a new delegate bound to a raw C++ member function. 
Creat eRaw expects a pointer to the object instance, and a function reference to the 
function to imcke on that pointer 

The third parameter for map ac ti on is a delegate to call to test if the action can be 
executed. Because we want the command to be executable ali the time, we can use 
a simple predepned delegate that aways returns t r ue. 

With an association created between our command and the action it should call, we 
non need to actual tl the extension system that we want to add new commands to 
the toolbar 

We can do this via the FExt ender class, which can be used to etend menus, 
context menus, or toolbars. 

We initialycreate an instance off Extender as a shared pointer so that our 
extensions are uninitialized when the module is shut down 

Wethen callcéToo! Bar Extensi on on our new extender, storing the results in a 
shared pointer so that we can remove it on module unintialization. 

AddTonl Bar Extensi on“ s prstargumentis the name of the tension point where 
we want to add our extension: 

To induere we vant to place our tension, ve rst need to tum on the display of 
‘extension points within the editor U. 
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39. Todo so, open Editor Preferences in the Edit menu within the editor: 
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Restart the editor, and you could see green text overlaid on the editor UI, as in the 
foloning screenshot 





‘he green text indicates UI Ext ensi aol nt and the texts value is the string we 
should provide to the AadToo Bar Ext ensi on function. 

Were going to add our extension t the Compile extension point in this recipe, but of 
‘course, you could use any ather extension point you wish. 

Ws important to note that adding a toolbar extension to a menu extension point wil 
fl sent, and vice versa. 

The second parametertoàdaTool ar Ext ensi on is a location anchor relative to 
the tension pant specpod. Weve selected F Ext ensi onkoak: Bel er e, so our 
icon will be displayed betore the campile paint 

The next parameter is our command list containing mapped actions, 

Finally the last parameter is a delegate that is responsible for actually adding U! 
controis to the toolbar at the otorsion point and the anchor that we speciped earlier: 
The delegate is bound to a function that has the form void (t tunc) 

Frocl aaraui I der andbui | der Intr instance, is a functon caled 
AatTosl bar Ext ensi on deredin our module css. 

When the function is invoked, calling commands on the bui der that add UI 
clare vil apply those elements t the location in the U we specie 


Lastly, we need to load the evel editar module within this function so that we can 
‘add our entender t the main toolbar within te level eat. 





As usual, we can use Nodul elsnager to load a module and return a 
reference to 

With that reference in hand, we can get the Toolbar Extensibilty Manager for 

"he module, and tel itto add our tender. 

While this may seemeumbersorne at prst, the intention ft allow yout 

apply the same toobar extension to multiple toolbars in different modules I you 
wouid Ike to create a consistent U layout between different editor windows. 

The counterpart to initializing our extension, of course, Is removing it when our 
module is unloaded. To do that, we remove out extension fom the extender, then 
nuli the shared pointers for both Extender and extension reclaiming thelr memory 
allocation. 
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55. ThekadToo! Sar Extension function within the editor module is the one which 
is responsible for actually adding Ul elements to the toolbar that can invoke our 
Commands. 


56. It does this bycaling functions on the F Tool Bar Bui I der instance passed 
inas a function parameter 


57, Firsty, we retrieve an appropriate icon for our new toolbar button using the 
FSI at el cen constructor. 


58. With the icon loaded, we invoke Aga oat dar 
instance. 


59. AdeToo| bar But tan has a number of parameters 


60. The þrst parameter is the comand to bind tyoul notice Is the samet Bu t on 
member that we accessed earlier when binding the action to the command, 


61, The second parameter is an override for the eension hook we speciped earlier, but 
we dont want to override that so we can use WANE None 


62. The third parameter is a label override for the new button that we create. 
63. Parameter four is a tooltip for the new button. 


64. The secondiast parameter is the button's icon, and the last parameter is a name used 
to refer to this button element fr highighting support if you wish to use the in-editor 
tutorial framework. 





tton onthebui Ide: 


new 





‘The verkon for creating new menu entries is almost identical to that for creating new toolbar 
buttons, so this recipe will build on the previous one, and show you how to add the command 
created therein to a menu rather than a toolbar. 


How to do it. 


1. Create a new function in your medal e class: 


void MddNenuEntensi onl Plesibul i der Gbut Ider} 
t 

Fslatelcen Iconrush = 

Fslatel con FEdi erst ye: Get Styl eset tamel | 
‘Level editor Vi ewOpt I ons" 

Level Edi tor. Vi ewOpt i ons, Smal 1 





bilder. AdaMenutntry|Foctboct Commands: : Get (1. MyButt on) 
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Find the following code within the Star upNods! e function: 
Extension = Tool berEvt enter hdiTool Bar Extension Congl et 
EEitensigsioot.:Getere, Commands 

FTool fareatensionDel gate: createdaal tals 

Vei Chok book Editor Mogul e: iAddTool sartrtensi oni | 


Level Ed torMadule. Get Tool BarExtensi Il tyManager() 
Shadeetenaert Tool barént enger 











Replace the preceding code wth the following 
Extension = Taslbarëxtender 
Dhadhenutetansioe| Level Editor", EEntensi onook: : Before, 
Cammanslist, Hensbrt ensi onbel egst e Crest eon this 

Met conkasok Ed tarea es Atene eos anl 
Level Edi torNadul e. Get Menužrt enal b |ityMenager‘ 1 
SadEntender | Toni barEatender) 








Compile your code, and launch the edor. 
Veritythat you now have a menu entry under the Window menu that displays the 
Cookbook window hen cicked. I you flowed the preceding recipe, youl also see 
"Be green tert listing the Ul extension points, including the ane we used in this recipe 
(Leveleditor. 


1 


‘oul ote tat Teo! bar Extender iof tpe Feat ender ratherthan 
FTool barEntender orPlerutxtender 

Byusinga generic extender dass rather than a specie subclass, the fameveric 
‘allows you to create a seres of command-funetion mappings that ean be used on 
either menus or toolbars. The delegate that actually adds the UI controls (n this 
instance, ie nu Ext ensi on) can link those controls to a subset of commands 
ftom ourF Ent enger 

‘This way. you dant need to have diferent TCo mands classes for diferent types of 


extensions, and you can place the commands into a singe central class regardless of 
ere those commands are invoked from the UL 
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4. Ae a resu, the ony changes that are required are as follows: 


1. Swapping cals to kédToo! Bar Extension with AddNenuExt ensi on 

2. Creating function that can be bound to enu Est ensi onDel egate 
rather than Tes bar Extensi onDel egit e 

3. Adding the extender to a Menu Exensibity Manager rather than a Toolbar 
Enensibity Manager. 





Custom editor windows are useful when you havea new tool with user-conpgurabie settings, 
or want to display some information to people using your customized editor. 


Be sure to have an editor module by following the recipe earlier in this chapter before you 
star 


Read trough either the Creating new menu entries or Creating new toolbar buttons recipes 
So that you can create a button within the editor that wll launch our new window, 


How to do it. 


1. Inside your command's bound function, add the following code: 
Tsharedhet cS ndon» Cookbook adow = Stew SH ndon) 
Titel Fent: Fronitri nol TEXT Cookbook M adoe"|)) 
CllertSizervecternni too, enn) 

Support saxi mi e| false 
Supports ni mi zel false 
i 
Shen Serti cal ae 
‘svert ical tors Shot] 
HAL ign HAli gn, Center 
VAL igni Val ign Center 
i 
suen(stext ect 
Testi Flext: FronStri agl TEXTO Helio from slate*|}) 





1 
Modul eNanager: : LoadNodul eCheckedel Mal afr ameNadul e> TEXT 
Vaters T 


14 DinErimelodu e. GetParent W ndo) Hat i9011 
t 
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Fslatedgpl | cati on: Get() Asam nden{ Coches ndowl 


Compile your code, and launch the editor, 


When you activate the command you created, either by selecting the custom menu 
option or the toolbar aption that you added, you should see that the window has been 
displayed wit some centered text in the mile 





How it works 


1 


Je shouldbe set explanatory your new editor window won display sell, and so, at 
"he start of this recipe, tis mentioned that you should have implemented a custom 
menu or toolbar button ar a console command that we can use t tigger the display 
otour new window. 

Al of Slate's widgets are usualyinteracted with in the form of TShar edRet < > or 
Tshareaptre > 





‘The tlw!) function etumsa Shar edite! templated on the requested widget 
dass 





gu- 
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As has been mentioned elsewhere in this chapter, Slate widgets have a number 
fof functions that they implement, which al retur the object thatthe function was 
inucked on. This allows for method chairing to be used to conpaure the object at 
creation ime. 

This is what allons forthe Ste syntax of <W dget >. Propert yi Value) 

Propert yl Val ue) 

The properties that are set on the widget in this recipe are the window tite, 

the window size, and whether the window can be maximized and minimized: 

(Once alli the requisite properties on a widget have been set, the bracket operators 

(T Jean be used to specify the content to be placed inside the widget, for example, 

‘a picture or label inside a button. 

SM ndow is a toplevel widget with only one slot for child widgets, so we dont need t» 
adda slot for it ourselves. We place content nt that slot by creating R inside the pair 
of brackets. 

The content we create is SVer t ical Box, which is a widget that can have an 
arbitrary number of slots for child widgets that are displayed ina vertical ist. 

For each widget we want to place into the vertical ist, we need to create 

asiat 

‘The easiest wayto do this is to use the overloaded + operator and the. 
SVerticai der: SI at] funtion 

SI ot (1 retums a widget ike any other, so we can set properties on ike we 

didon ourSi «do. 

This recipe centers the Slots content on both horizontal and vertical aes using 

HAL ign andvat i gn. 

ASI ot has a single chid widget, and its created inside the operators just as for 
SW ndon. 

Inside the iat content, we create a tet block with some custom text. 


Our nen St ng aw now has its child widgets added, but it isn't being displayed yet, 
because it isnt added to the window hierarchy: 

The main frame module is used to check if we have a top-level editor window, and fit 
‘exits, our nen window is added as a child. 

I there's no top-level window to be added as a child to, then we use the Slate 
Benlcation singleton to add our window without a parent. 

Ifyou would ike to see the hierarchy of the window we've created, you can use the 
Sate Widget Recto, which can be accessed a Window | Developer Tools | 
Widget Rector 
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20. you select Pick Live Widget, and hover your cursor over the tetin the center af our 
Custom window, you wil be able to see the SWindaw with aur custom widgets added 
to ts hierarchy 





See also 


‘Chapter 9, User Interfaces — UI and UMG, al about UI, and wil show yeu hon to 
‘add addtional elements to your new custom window 





ting an 





Asset type 


At some paint in your project, you might need to create a new custom Asset class, or sample, 
an Asset to store conversation data in an RPG, 


In order to propertyintegrate these with Content Browser, oul need to create a new 
eset pe 
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1. Create a custom Asset based on Ij ect 
n" 


include zDbj ect. ie 
Finci cds “WyCestonkeset. generated, n" 
vuetassi) 
Class VEACOOKBOOK_APL UNyCustomksset : public UONI ect 
t 
sENERATED, soov) 
public 
ÜPROPERTYL Eai tAayuhere, Category = “Custom asset“) 
Fstring ane 
n 


2. Create a cass called UCust omAsset Factory basedonUFact ory, 
vending Factor yCr eat enen: 


teragme once 


nel ude ‘Factori eni Factory. ht 
incise “Customeset factory generated. bt 


vuctassiy 
(laze UEACOOKBOOK_API_UCustomMsset actery : publie UFactory 
t 


sENERATED, Boor) 


public 
Ucustameser Factor 





ictal ob) ect® FactoryCreatenew UC asst tact ass 
objects InParent, hans Iname. EOB) ect lags Flags 
doeet Context, FFeedzeckcontaxt® Mara, Plame 
Call ingcontent) override 

n 


3. Implement the class: 
#i ncl ade *UEdCookbook. ht 
include “Wycestomisset. h 
finci eae “Custemeset Factory. 


-gnj 
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Hass, Uos|ect! Contest, FFeedzeckCentent® Mars, Fame 
auta newDbjectAsset = Newb] ect ell Costomtesst(\nfarent 





Compile your code, and open the. 





iar 
Right-click in Content Browser, and under the Miscellaneous tab of he Create 


Advanced Asset section, you should see your new class, and be able to create 
instances f our new custom type. 
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1. The rst class is the actual object that can exis inthe game at runtime. Its your 
teure, data He, or curve data, whatever you require. 

2. Far the purpose of this recipe, the simplest example s an asset that has an St ing 
ropertyto contain a rame. 

3. Thepropertyis marked as UPROPERTY so thatit remains in memory, and 
additionally marked as Edi t Any uere so that its editable on both, the default 
‘object and on instances ofi. 

4. The second classis Factor y. Unreal uses the Fact or y design pattem to 
create instances of assets, 

5. This means that there is a generic base Fact ory thatuses virtual methods 
to declare the interface of object creation, and then Factor y subclasses are 
responsible for creating the actual object in question. 

6. The advantage of this approach is that the usercreated subclass 
‘an potentially instantiate one of ts oun subclasses i required it hides the 
implementation details regarding deciding which object to create away fom the 
object requesting the creation. 

T, With UFact or y as our base class, we include the appropriate header 


3. The constructor is overridden, because there are a number of properties that 
we want to set for our new factory after the default constructor has run. 

9. br eat eeu sg that the actoris currentiyable to create a new 
instance of tne object in question from scratch. 

10. bgi t At ter New indicates that we mould like to edit the newly created 
object immediately after creation. 

11. TheSuppor tedcl ass variable is an instance of UCI ass containing 
rejection information about the type of object the factory wil create. 

32. The most sigriþeant function of our UF ac tor y subclass is the actual factory 
method-FactorjCrest een. 

13. Factor yCr eat eNew is responsible for determining the pe of object that 
shouldbe created, and using Newb ect to construct an instance of that type. It 
passes the folloning parameters through to the end ect call 

14. i nI ass is the class of object that wil be constructed. 

15. 1 nPar ent is the object that should be containing the new object that wil be created, 
this ient specie the object is assumed to g into the transient package, wich 
means that ft wont be automatically saved. 
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16. Nane is the name of the objectto be created. 


17. Flags is a bitmask of creation fags that conto things such as raking the object 
Visible outside of the package itis contained in. 

18. Within Fact or yCr eat eNew, decisions can be made regarding which subclass 
should be instantiated. Other initialization can also be performed: for example, f 
there are sub-objects that require manual instantiation or ingialization, they can be 
added here. 

19. An example from the engine code for this function is as follows: 
obj ect cameraksiafactory::FactaryCreat een Class" 

(late Uob ect! InParest, Fane Name, Lon eet Page 

Flags UO) ect* Context, FFeegbactCoatext® Marn) 

t 
Mewdb| ect <UCamer aani oi inharert, Class, Mame, Flags) 
Nedj ect «Ui nter püroupCarera» Netamkni m 
Mexcenhei m sCamsral ateraGroup->Grouplame = lane 
return Newtamani m 

] 


20. Ae can be seen here, there's a second call ta Newb ect to populate the 
Camer al nter pGr oup member ofthe KeuCa sisi» instance. 


See also 


1 The Editing class properties in different paces in the editor recipe earlier inthis 
chapter glues more contet to the Edi t o her propertyspediper 





m context menu entries for 





Custom Asset types commanly have special functions you wish to be able to perform on them. 
For example, converting images to sprites is an option you woulé want to add to any other 
‘eset ype. You can create custom corte menu entries Ter specibc Asset types in order to 
make tose functions accessible to users, 
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1. Create a nen class based on Asset TypeAct ions, Base. Youtlneed o include 
Asset Typekcti ons. Base.  inthe header He. 

2. Override the folowing virtual functions in the class: 
virtual bool Masàctions(const Tarray<UObject*>6 Intbj ects) 
Const override 


Virtual vaid Getactigos( const Thrray etu] eet*>6 | nab] ects, 
Panis dert Wensbul der] override 


virtual Fert Getane|| const averri ge 
Virtual Uclass* GetSupportedtiass() const override 





virtual Feotar GetTypecol arl) const override; 
Virtual winta? Getcategories[) override 


3. Declare the folowing function: 
vaid MyCustomksset Context Cli cted(] 


4. implement the declared functions inthe. cor He 
hen FiyCestonlssel ict ons: asit ions const 
Tarrayelobject*>G Intejects| const 
( 


i 


Vaid FWyCustomsssetActlons:: Get Act ons| const 
Tartayeioo]ect*»t Inoojects, PMeniBull gerd Menubui der] 
t 

Menaul i der. addenuťnteyi 

Hent: Fromstri agl" Custamassetact i ne] 

Het; FronStri ssl Action fram Cookbook Reci pe"). 

Fslatel con(FEdi tor Styl es: Get Styl eSet Namel 

‘Level Editor, Vi ewbpt ons? 

FulActi ant 

Fexecut ection: :CeeateRaa! this 

AEN Cost ons seL Actions: W Customsset Cont ext Cli ced) 

Hüstsecutektti enl) 





, 
vata FitpCustombeset Acti ons: GetCategari esl} 
t 

return EAssetTypetat egor ies: Wise 
i 


Text PMyCustomässetActions:: GetName[) const 








t 
return Feats: Fronitri ng TEXTI “Ny Custom Asset*)) 
j 
Uclase® Fiycustonssset Act ons: :GetSuppartedtlass[) const 
t 
return UnyCustomksset::Statictlass() 
i 
Falar FityCustomeset icti onsi: GetTypeCeler(| canst 
f 
tetara colar: Emerald: 
] 


Vai dPMyCustomksset Acti ons::MyCustambsset Context (Ii ckedl) 


Tsharedaet SM ndow> Cookbook ndow = Stew! SM ndol 
We le( Fest: Fronitri ngl TEXTI "Caoktaok Window") 
Client size|Fvecter20(480, 400)) 


Susportshaxi mi ze( Fal sel 
SupporesW aim ze( al sel 


Iai nframeNadul 26 Wal nFraneodul e 
Fast! eienager:Loaahadul eCheckade Wal nr ameliodul e> 
Text Mal rame] 


It (Wal sirameMdu e Get Parent née aL £1) 


i 
Slat eappl ication: Get Add adowAsativechll ¢ 
(Cookbook ndam, Mai ntraneodul e. GetParent W nds] 


Tosnaredter (i 
) 

E 

i 


Fslatekppl ication: Get] Addii adowl Cookbook M ndo): 


D 
k 


Within your edor module, add the following code to the St ar t uplodat 
function 

asset Tool s& Asset Toots = 

Fagul eNanager:: LoadNodul eChected eH Asset Tool sadul e>{* Asset 
Tenet Gat) 





auto Actions sWakeShareab e| new Fi CustonissetKti ons) 
eset Tool s.egisteresst Ty petet ensi det ions] 
CrestedtesstTypedeti ons, Mal Actions] 


mj 
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5. Add the folowing inside the modules Shat own Modul l| function: 


Fagul eNanager:  LozdNodul eChecteteH eset Tosl sadul el "Asses 





[ 
dest Tools, Unreglsterasset tye 
diction tesserae] 

i 








1. Compile your project, and launch the editor. 
B. Create an instance of your custom Asset inside Content Browser. 
3. ightcick on your nen Asset to see our custam command in the context menu. 





10. Select the CustomAssetAction command to display a new blank editor window 








1 


x. 


E 


n 


ES 


The base class for all asset tpespecipc contest menu commands is 
FassetTypeActi ons Base, so we need to inherit from that class. 
FhssatTypeketi ons Bose is an abstract class that depnes a number of 

virtual functions that alow for extending the context menu. The interface which 
Contains the original information for these virtual functions can be found in 

asset Typekcti ons. h 

We also declare a function which we bind to our custom context menu entry: 
AssetTypedcti ons: :Masactions | const TArrayeltb| ect #96 

| nb ect.) i the function called bythe engine code to se if our 
Asset Ty pedct ons dass contains any actions that can be applied to the selected 
objects. 

Asset Typekcti ons: Get Act ions| const TArray<Uobjectt>6 


Indbj ects, class FMeneBsi der Mensbai Ider | is called ifthe 
HasAc ti ans functon retums tr ue. I calls functions on ensBai | der to create the 


menu options for the actions that we provide. 
1AssetTypeActi ons:: Get Name(} retums the name of this class. 


1 AssetTypeActi ons: Get Support edt! assi ) retums an instance of 
Uci ast which our actions class supports. 

LlssetTypekcti ons: : GetTypeCol or (1 retums the color associated 

with this class and actions 

asset Typekcti ons:: Get Categori esl) retums a category appropiate 
forthe asset. This is used to change the category under which the actions showin the 
context menu. 

Our overridden implementation of as Act i ons simply retums true under 

all Greunstances relying on fitringbased on he results of Get Support dC! ass 
Inside the implementation of Get Act ons we can eal some functions 

onthe Menu dr object that we are given as a function parameter. The 

eris | der i passed as a reference, so any changes that are made byour 
function wil persist after it retus. 

AddMenuEnts y has a number of parameters. The prst parameter is the name of the 
action itself. This is the name that wil be visile within the conto menu. The name 
isan FTert so thatit can be localized should you wish. For the sake of simply, 
e construct FText froma string teal and dont concem ourselves with multiple 
language support 

The second parameter is also F Text which we construct bycaling. 


Fest: Fr omst r i ng. This parameter is the tex displayed on a tooltip ifthe user 
hovers over our command for more than a smali amount of ime 
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14. The nest parameter is FSI at el con forthe command, which is constructed from the 
Level Editor. Vi ewOpti ons icon within the editor style set 

15. The last parameterto this function is an FUI Act i on instance. 

The FU! Act i on is a wrapper around a delegate binding, so we use 
fF Ececutedcti ons: Createkau to bind the command to the Ny Cust omisset _ 
Clicked function on this very instance of Ny Cust omdsset Act ons 

16. Tis means that when the menu entyis clicked, ourtyCust enksset Context 
Cli eke function wil be un. 

17. Our implementation of Get Name retums the name of our Asset type. This string wil 
be used on the thumbnail for our Asset f we don't set one ourselves, apart from 
being used in the title of the menu section that our custom Assets wil be placed in 

18. As you'd expect, the implementation of Get Suppor tedC ass retums 
Ulytostosasset: Stati cCIass[ ) as this is the Asset type we want our actions 
to operate on. 

19, Get Ty pecel er) retums the color that wil be used for color coding in Content 
Browser--the color is used in the bar at the bottom ofthe asset thumbnai! Ive used 
Emerald here, but any arbitrary colar will work. 

20. The real workhorse of this recipe is the MyCustamAsset Context 
Cli ckea( | function. 

21. The frst thing that this function does is create a newinstance of SW ndo. 

22. SW nto is the Slate Window-a class from the Slate UI framework, 


23. Slate Widgets are created using the SNe w function, which retums an 
instance of the widget requested. 

24. Slate uses the bui I der design patter, which means that al the functions that are 
chained alters New retums a reference to the object that was being operated on 

25. In this function, we create our new Si né ov, then set the window title, ts 
client size or area, and whether it can be maimized or minimized. 

26. With our nen Window ready we need to get a reference to the root window forthe 
editor so we can add our window to the hierarchy and get played, 

27, We do this using the | Nai nFr ameNogul e class. Its a module, so we use the 
Module Manager to load it- 

28. LoadModul echec ted wil assert if we cant load the module, so we dont need to 
checkit. 

29. 1f the module was loaded, we check that we have a valid parent window. If that 
window s valid, then weuseF S! ateAppl icati on:: AtW ndowàs ati vehi I d 
to add our window as a chid of the toplevel parent windon. 
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3. 
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3. 


D 


a. 


a 
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if we dont have a top-level parent, the function uses dW «dow to add the new 
window without parenting it to another window within the hierarchy. 

So now we have a class which wil display custom actions on our custom Asset type, 
but we need to actually tell the engine that it shouid ask our class to handle custom 
actions tar the type. In order to do that, me need to register our class with the Asset 
Tools module. 

The best way to do this is to register our class when our editar module is 

loaded, and unregister it when is shut down 

Be a result, we place our code into the Start upNodu! e and 

Shut downiiogul e functions. 

"nsidest artupNodul e, we load the Asset Tools module using Module 

Manager. 

With the module loaded, we create a new shared pointer that references an 
instance of our custom Asset actions class 

Al we then need to dois callas set iodul e 

RegisterAssetTypeacti ons, and pass in an instance of our actions css. 
We then need to store a reference to that ct i ons instance so that we can 
unregister it later 

The sample code for this recipe uses an array of all the created asset actions 

in case we want to add custom actions for other classes as wel 

Within Shut down Mo du e, we again retrieve an instance of the Asset Tools 

module. 

Using a range based for loop, we terate over the array of Act ons instances 
that we populated earlier, and callunregi ster Asset Typedcti eas, passing 
inour act ans cass so can be unregstered. 

With our class registered, the editor has been instructed to ask our 

registered class if it can handle assets which are rightzlicked on. 

M the asset is of the Custom Asset class, then ts St si cC! sss will match 

Me one retumed byGet Suppor teac ass. The editor will then call Get Actions, 
and displaythe menu with the alterations made by our implementation of that 
funcion. 

Wen the Cust oms set Acti on buton is cicked, our custom 

MyCustamasset Context, CÓ ced function wil be called via the delegate 

tat we created. 
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ng new console commands 





During development, console commands can be very helpful by allowing a developer or 
tester to easily bypass content, or disable the mechanics not relevant to the current test 
being run. The mast common way to implement this is via console commands. which can 
invoke functions during runtime. The console can be accessed using the te key -] or the 
equivalent in the upper area of the alphanumeric zone of your keyboard. 











Getting ready 


if you haven already followed the Creating a new editor module recipe, do so, as thls recipe 
mil need a place ta initialize and register the console command, 


How to do it... 


1. Open yur editor module's header He, and add the following code: 
sel eConmand Di spl ayUser Speci Fi edit ndaw: 








2. Add the folowing within the Implementation ofS art up edat 


sal ehanagers der). Register Consol 
Camaaat sioe], TENT) test" 
FeonsaleConmsodDelegate:. Crest efau( thls 











Teonselalsnager: Gett] Registertensal eCommand( TEXTI "DI splay 














' 
Fir eg Wndowtitie 
for (FString Arg c args 





t 
Wodeetitle 
WodoeTi tle. dppendcear(’ n) 
] 
thi s- bi spl ay ndewr W ndowTi t el 
à 
J. EU Default): 


3. Inside Shat down Node! e, addthis: 
1t (Displaytest Comandi 


‘consol ehanager:: Get |}. Unreal ster Consol edb] ect 
ImisplapTest Command) 

DisplayTest Command = nul ptr: 

] 

1 (DisplayuserSpeci tied ndowh 

( 
I consol eanager:: Get |}. Unregi ster Consol edb] ect 
Bis agtest Command) 
Dieslaytestcenmang = nul I ptr: 

" 


4. implement the folowing function in the editor module: 
void DisplayW ndowlFString MndowTi tie) 


Tsharedaer SM ndow> Cookbook dew = Stew! SM ndol 
Tel Test: render agi Wageat tial] 
Client size|Fvecter20(420, <)) 
Supportahan zel alse] 
SusportaMiai m tela sel 
I 
Fast! everager. LesiHodal eCheckade Mai nFr ameliodul e> 
TEXT "wal frame) 
1E Di aFrameMaaul e. Get Parent M ndowt |. IsYali dl)) 
D 
Fiat epp ication: Get |. Add adowAsati vechi ¢ 
(Cookbook ndam, Maintraneodul e. GetParent W nds) 


prom 
l 
i 


Fsiatehppl ication: Get |. Addik adowl Cookbook ndo): 


m} 
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5. Compile your cde, and launch he editor 
5. Playthe level, hen hit the ide key to bring up the console 
T. WpeDisol ayTest Commands néow, and hit Enter 


me: Bswean 6o m Content » 





3. You should see our tutorial window open up: 





1. Console commands are usually provided by a module. The best way to get the module 
to create the command when itis loaded is to place the codein thestar tuplodal e 
method 





2. i Consol eMfanager isthe module that contains the console functionalty for 
the engine. 





Copter 





x. 


A itis a submodule of the core module, we dort need to add any additional 
information to the build scripts to link in addtional modules. 
In order to call functions within the console manager, we need to get a reference to 


te curentinstance of I Consol eNanager that is being used by the engine. To do 
50, we Invoke the static Get function, which retums a reference o the module in a 


similar wayto a singleton. 
Register Consel eCommand is the function that we can use to add a new console 
command, and make it available in the console: 

virtual IConsoletommandt RegisterConsal eCommand| const 


TCHAR: Name, const TCHARY Help. const 
FConsoleČommandDel epit ek Command, sint32 Fiags) 


The parameters for the function are the following: 


1. Name: The actual console command that wil be typed by users. It should not 
include spaces. 

2. Hel p: The tooltip that appears when users are looking at the command in 
the console. If your console command takes arguments, s is à god place 
to display usage information to users. 

3. Command: This is the actual function delegate that wil be executed when 
the user types the command. 

4. Flags: These flags conto silty of he command in a shipping build, 
andare aso used for console variables. ECV Def au! t species the 
default behavior wherein the command is visible, and has no restrictions on 
availabilty in a release build. 


To create an instance of the appropriate delegate, we use the Cr eat eRaw static 
function onthe Consol e Comsand delegate type. This lets us bind a raw C++ 
“function to the delegate. The entra argument that is supplied after the function 
reference, the String "Test Command Window , iS a completime depned 
parameter that is passed to the delegate so that the end user doesn't have to specify 
the window name. 

The second console command, Di sp! ayUser Speci i edW néow, is one 

that demonstrates the use of arguments with console commands. 

The primary diference with this console command, aside from the diferent 

name for users to imoke Iis the use ofF Consol eCommandMi t hArgsDel egate 
andthe Creat eLanbaa function on tin paricuar. 

Tris function allows us to bind an anonymous function to a delegate. Its particulary 
handy when you want to wrap or adapt a function so its signature matches that ofa 
particular delegate. 





mj 
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2. 


In our particular use case, the type off Cons o! eComan £M thar gsDel egat e 
species that the function should take a canst Tar ray of FStringe. Our 

Di spi ay tk néen function takes a single F 5t r1 ng to specify the window tile, so 

we need to somehow concatenate all the arguments of the console command into a 
singeFStri ng to use as our window tite. 

The lambda funcion allos us t do that before passing the St ri ng onto the actual 
Displ ay tk gow function. 

The þrstlineofthe function, G] [const TArray<FString>b Args) 

‘species that this lara or anonymous function arts to capture the contet ofthe 
declaring function by reference by including the ampersand in the capture options 
[5 

The second part is the same as a normal function declaration specifying that 
ourlambda takes in const Tar ray containing FStrings as a parameter called Ar gs 
Within the lambda body, we create a new Fst ri ng, and concatenate the strings that 
make up our arguments together, adding a space between them to separate them so 
hat we dont geta ttle without spaces. 

"uses a rangebased or loop for brevty to loop over them all and perform the 
concatenation: 

Once theyre all concatenated, we use thet hi s pointer (captured by the é operator 
mentioned earlier) to imoke Di sp! ay W now with our new ttle. 

"n order far our module to remove the console command when itis unloaded. 

we need to maintain a reference to the console command object. 

To achieve this, we create a member variable in the module of type 

I Consol eCommand", called Di spl ayTest Command. When we execute the 

Regi ster Consel eCemmans function, it retums a pointer to the console command 
object that we can use as a handle later 

This allows us to enable or disable console commands at runtime based on 
gameplay or other factors. 

Within Shat down Model e, we check to see fDi spl ayTest Command refers 

to a valid console command object. fit does, we get a reference to the 

ones! etanager object, and cail unr egi ster Consol eCommand passingin the 
pointer that we stored eater incur callto Regi st er Consol eComsand. 

The calltoUnr egi ster Conso! eComand deletes the! Consol eCoemné instance 
via the passedn pointer, so we dont need to dea! | cat e the memory ourselves, 
justreset Di spl ayTest Command tanul ptr so we can be sure the old pointer 
doesnt dangle 





Capers 

23. The Di spl ay adou function takes in the window title as an FSt ri ng parameter, 
This allows us to either use a console command that takes arguments to specify the 
tle, ora console command that uses payload parameters to hard-code the title for 
ather commands. 

24. The function itself uses a function called Seut} to allocate and create an Si ede 
object, 

25.58 ndow is a Slate Window, a top-level window using the Slate UI framework. 


26. Slate uses the Bai I der design pattem to alow for easy conbguration af the 
‘en indon. 





27. TeTi tl e, Cli entSi ze Supports Maxi mi ze, and Support si ni si ze 
functions used here, are all member functions of SW néow, and they retum a 
reference to an SH nda u (usually the same object that the method was invoked on, 
but sometimes, a new object constructed wth the new conpouration] 

28. The fact that ali these member methods retum a reference to the conpaured object 
Allons us to chain these method invocations together to create the desired abject in 
heri conbouraton. 

29. The functions used in Di spl ayW now create anew topdevel Window that has 
a te based on the function parameter It's 800340 pbs wide, and cannot be 
maximized or minimized. 

30. With our nem Window created, we retrieve a reference to the main application frame 
‘module. Ifthe toplevel windo for the editor exits and is valid, we add our new 
indo instance as a chid of that top level window. 

31, Todo this, we retrieve a reference to the Slate interface, and call 
AAM ndawas Nat i vechi e to insert our window in the hierarchy 

32. If there ista valid toplevel window, we dont need to add our new window as a 
child af anything, so we can simply call Ada W nées, and pass in our new window 
instance. 


See also 


^ Refer to Chapter 5, Handing Events and Delegates, to learn more about delegates, 
explains payload variables in greater detai. 


For more information on Slate, refer to Chapter 9, User Interface. 
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ualizer for 





Creating a n 
Blueprin 


Within the Blueprint system, we can use instances of our My Cus tomis et clas as variables, 
provided we mark that class as afi uepri nt Type in its UCLASS macs 


raph pin vi 











However, by default, our new assets simpy treated as UObj ect, and we cant access any of 


For some types of assets, we might wish to enable nine ding of eral values in the same 
waythat classes such as Vector support the following: 


In order to enable this, we need to use a Graph Pin visualizer This recipe wil how you how 
to enable iine editing of an arbirarylype usinga custom widget debned by you. 


How to do it. 


1, Gate a newhender He called Wy Cast asset Pi Factory. h 
2. Inside the header, add the following code: 

incl ade “Eagraphuti iini es he 

Anci de “Wycestomisset. n 


Kuet UEACOOKBOOKEDI TOR AHI. Fly Cost ontsset Pi nřactery 








public 
Virtual TéharedPtreclass Soraphel n> CreatePi el class 
aorapari nr Piel const override 
1 
1 (Pin->PinType. PinSubtategor yobi ect 
UMyCustomksset: Stati ctlassl]] 





( 
return Stew! ScraphPinCustomsset. Pial 
] 
$ 
tetara aull tr 
7 
» 
i 


Create ancther header be caled sGr aph Pi nCust omisset 


n 
Pael ade *SéraphPl n. 


lass UEACOOKBOOKEDI TOR, AMI. SGraphPi nCustomksset = public 
Soraperin 
t 
SLATE BEGI NARGSI SGraphPi ncustomsset] () 
SLATE END MRGS(I 
aig Gonstract(censt FArgunaeted Inàrgs, UEdGraptFi at 
Tapia) 
protected: 
Mirtusl FSlatecelar GetPincolor(] const override | retura 
Fl atecol eri eal ers Black]: } 
virtual TSharedRef «5M dget> Get Def aul t Val uet dget 1) 
Berride 
al # Col orPi chedl FL nearCol or Selectestol er) 
I 


Implement aphPi nCust omisset in the. cop He: 
#i ncl ade *UEdCookbookEditor. h" 

finci ede “Sco! orPi eker. bt 

acl ude “SGraphPi acustombsset + 


void SraphPi acustomlsset: Construct (const Fargumeets& Inde ge 
UegGeapher ne tat at 
t 

Sr aphPi nic Construct I SGraphPi n: : FArganenta(). Ibin) 
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] 
Tsharedtet «sw ager» 
SGraparincustemsset: Get et auta ue aget | 
í 
return Shenl Sal orPi cker | 
OnCol or Commi tt edita s 
iStraphalacestonteset Col or Picked 
i 


vol SüraphPi sCustomsset:: Col arbi ced FLI esartoL 
Selecteveslor| 
i 
unycustamieset™ Newal us = Newb) ect elnycustemdeset>|) 
Newal ue calariam 
Selecteacaler-T2Fea! art 
Graphpi atn stet scher (I 
SIE ySet Bet aul aj cr GraphPi nos), MWewal uel 
1 


5. Addsincluse “Chapterd/ycustombsset detail scustem zation. h tothe 
UetConh teat dior module implementation he. 


5. Add the folowing member to the editor module class: 
Tsharedhtr<fl Cust ombsset?laFactery> Pi aFactery 





false) Token] 


7. Add the folowing to Start upledute|) 
Pi nfactary = MakeShareabl e| new FH) curt omiesetD nFactoryl}) 
FedGrapnbt ities: ifepistervi sual Pi nFactery|PiaFactery| 





3. Aso add the following code to Shut downed! el | 
Filtra phüt ities: unreal teri sual Pl nctory(PlaFactery 
PinFactory,Reset(| 

3. Compile your code, and launch the editor. 


10. Crete a nen Function inside the Level Blueprint by clicking on the plus symbol 
beside Functions within the My Blueprint panel 
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11 Add an input parameter, 





12. Setite type toNyCustomisset (Reference: 





13. in the Leve Blueprints Event graph, place an instance of your new function, and 
ve that the input pin now has a custom visualizer In the form of a calar picker: 
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Customizing how objects appear as literal values on Blueprint pins is done using the 
ForaphPanel PinFactory dass, 

Tris dass detnes a singe virtual function: 

virtual TSharedPtreclass SGrappPia> Createrin( class 

Uedcrapnrine Pin) const 


The function of Cr eat ePi s, as the name implies, is to create a new visual 
representation of the graph pin. 

Itreceives a UEdGr aphPi n instance. UEdGr aphPi n contains information 

about the object that the pin represents so that our factory class can make an 
informed decision regarding which visual representation we should be displaying. 
Within our implementation af the function, we check that the pin's type is our custom 
dass. 

We dothis bylooking atthe i nSubCateg2ry 0b ect property, which 

Contains a UCI ass, and comparing itto the UC as s associated with our custom. 
asset cass. 

ifthe pin's type meets our conditions, we retum a new shared pointer to a Slate 
Widget, which is the visual representation of our object. 

ifthe pin is of the wrong type, we retum a null pointer to indicate a failed 

state. 

The next class, SGr aphPi Customs set , is the Ste Widget class, which is a visual 
representation of our object as ateral 


Itinherits rom SGr aphPi n, the base class for all graph pins. 
TheSGraphPi nCust omisset class has a Const ruct function, whichis 

called when the widget is created. 

"Lalo implements some functions from the parent class: Get Pi n Col or |) 

andGet Default Valuel dget 

The last function depnedis Col or Pi cked, a handler for when a user selects 

a color in our custom pin. 

"n the implementation of our custom cass, we initialize our custom pin by 

calling the default implementation of Const r uct 

The ole of Get Det aul tal uel dget is to actually create the widget that 

1S the custom representation of our cas, and return tothe engine code. 

In our implementation, t creates a news Col or Pi cter instance-we want the user 
"o be able to select a color, and store the hexbased representation of that color 
inside the stri ng property in our custom class. 
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‘This Col eri cker instance has a property called OnCel or Commi tt ed—this isa 
‘late event that can be assigned to a function on an object instance. 

Before returning our new Col eri cet, welinkünel or Comi tt 

to thecol or Picked function on this curent object, so itwllbe called ifthe user 
Selects a new color. 

‘The Col or Pi cked function receives the selected color as an input 

parameter, 

Because this widget is used when there's no object connected to the pin we are 
associated with, we can simply set the property on the associated abject to the 
desired colar sting. 

We need to create a new instance of our custom asset class, and we do that 
byusing the Nenon ect template function: 

‘This function behaves similariyto the Spam t or function discussed in 

other chapters, and initializes a new instance of the speciped dass belore retuming a 
pointer toit. 

With a new instance in hand, we can setis Col or Name property: 

FLi near Col ors can be converted toFCol or objets, which depneaT ake r | 
function hat retums an F Str i ng with the hexadecimal representation of the color 
hat was selected on the new widget. 

Finally we need to actually place our new object instance into the graph so 

that it wil be referenced when the graph is executed 

To do this, we need to access the graph pin object that we represent, and 

use the Get Sc hena function- This function reums the Schema for the graph that 
‘ns the node that contains our pin: 

‘The Schema contains the actual values that correspond to graph pins, and is 

key element during graph evaluation. 

Now that we have access tothe Schema, we can set the defaut value for the pin that 
Gur widget represents. This value wil be used during graph evaluation if the pin sn 
Connected to another pin, and acts Ike a defaut value provided during a function 
delriionin Ct: 

Je with all the extensions weve made in this chapter, there has to be some sort of 
initialization or registration to tell the engine to defer to our custom implementation 
before using its defaut inbuilt representation. 

In order to do this, me need to add a new member to our editor module to 

sore ourPi nFa ctor y class instance. 

Duringst ar tupModul e, we create a new shared pointer that references an instance 
ofour?i aFactory cass 
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31, We store inside the editor modules member so it can be unregistered ter Then 
wecalisEeGraphiti liti esi fagistervisual i oFactory|PiaFactery| 10 
teli the engine to use our Pi nF act or y to create the visual representation. 

32. DuringShut dawaNadal e, we unregister the pin factory using 
UnregisterVi sual Pi nřactory 

33. Finally we delete our old Pi Fact or y instance byealing Reset | 
painter that contains it 





on the shared 








By default, UC ect - derived UAssets apen in the generic property editor t looks Iie the 
following screenshot: 





However, attimes you may wish for custom widgets to allow eding of properties on your class, 
Ta facitate this, Unreal supports Detalls Customization, which is the focus of this recipe. 


How to do it. 


1. eatea newheader He called My Cost omis set Detal sCostoni zati en. h 
2. Add the folowing includes to the header: 

#i ncl ude “Wycustomisset, h 

nel ade “Detali Layout Bul der 

include “I Propert yTypeCustomi zati on. h 








B 


Dene our customization cass as follows: 
clase fuycustomtesetDetal lsCustomi zation © public 
ToetasiCustem sat on 
f 
public 
‘eval volé Custom zepetai e] Detali Layautet deri 
Detali bell aer) averride 
ald Col erPichea| i nearCelor Sel ectedtol or); 
Static TSharediat d Detal Custom zati an> 
Figcustamdeset etal sCustem zati en: Makel astane 
1 





Ketura Makeshareabietnem 
Fiytustontaset etai Customization] 
) 
Tieztbtj ectPtreclass UMrtustorasset» WyAsset 
I 


Inthe implemertation He, create n implementation for 
Custom zeDetai 1s 
"T 
Fiytustontset Detal I scust n zati on:: Custom zeDetal s(t deta 
l Layostaui iderg Detail ul ger) 
t 
konst TArraye TWeakdb) ect Ptr eUObj ect ooi Selectedabj ects 
Detail Bui I der. Get Detal ISVi ew] | Get sel ect edon] ects) 
far [int32 Objeetindex = 0; IHyasset. lsali dl | d 
Dh etti eden < Select eaos) erts- Mumi): +40 ect! nden) 
1 





canst TWeak0bj ect Pr <0] ect>4 Current aj ect = 
Select edo) ects 02) ect index] 
1 CearreatOhj ect Isai (11 
t 
WyAsset = Cast <UMyCastomksset>( Current Obj ect. Get (1): 
1 
) 
Detal I al er. Edi Category "Custontot egory* 
Flet: “Geremi yl |, ftategerphriority: I meerkant) 
Mátusterhani rest Get Engt |) 
i 
swen(svert i cal tox) 
4 sverti cal Bor: Sot] 
Vali enge Center 
i 
Shen) Col or Pi cker) 
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Oncol arCommiteedi tals 
kN Cost isset Det ai sCustom zati on: Col erPicted) 
1 
1 
, 


‘Aso create a deprition force or Pi eked 
veld 


Fijtustontsset Detal I scust om zation: : Cal ori ckedl Li neartol o 
r'electestol eri 





Masset. Isali 





Nisset. Get()->Col orane = 
Select eg¢s| or Tarcol ar [fal se). Tokex| 
D 
' 


Lastly add the following includes in the. cpp Ble: 

#i nci ade *UEdCookbookeditor. h" 

finci ede *IDetalisview ht 

acl ude “Detail Layout Bul i derb" 

* ntl ide “Detail Cat eger bul der. 

#i nci ede “Stel or ker bt 

fiche "Sáothanel. n 

#i ncl ede “beta dget Row. t^ 

‘include *WyCustomAssetDet ail sCustomi zati on. h" 


In our esitor module header, add the following to the implementation of 
StartupNodal e: 

FPropertyēditarModulek Propertyhodale = 

Fuada changer  LaadNadul ethectate? Property Edt orModul e 
Tapert yedi tari 

PropertyModule, Regi sterCustenclaeeLayost| UyCustamtesets: S 
titel as! |->GetFaame| 

Fontes Det sli Carton estan! nstance: :Createstati el 6FayCustank 
ssetDetal Custom ration: : Makel ast ance | 








‘4d the following to Shutdown Wada 
FPropertyeditornasul et Propert atate 
Fadu eNanaoer. Lidia ethectete? Property E6torMedul eo 
reperit tor" | 

Propertyhodul e. Unregi ster Custonti ass Layout (UNyCust enbsset. 
Statlect asst) 9Get Panel) 
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3. Compile your code, and launch the editar Create a new copyof Wy Cast omis set via 
‘he content browser, 





10. Doubleclick on itto verify that the defaut editor now shows your custom layout: 





1. Dells Customization is performed through the Det ai | Cust osi zati on interface, 
"lich developers can inherit fram when depning a class which customizes the vay 
‘assets of a certain class are displayed 

2. The main function that Det si! Custani zat i on uses to alon for thie process to 
occur the following: 
virtual vald Custom seteta isl Detail Layout Bul I derk 
Detal ul der) override 


3. Within our implementation of this function, we use methods on 
Det i184) I der passed in as a parameter to get an array of al selected objects. 
The loop then scans those to ensure tata least one selected abject à of the correct 
‘ype 

4. Customizing the representation of a class is done by cling methods onthe 
Detail au, leer object We create a new category or aur detalls view by using the 
Edi tat egor y function. 
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The rst parameter ofthe si Cat eger y function is the name of the category we 
are going to manipulate. 

The second parameter is optional, and contains a potentially localized display name 
forthe category 

The third parameter is the pity of the category: Higher priority means tis displayed 
further up the list. 

Edi tCat egor y retums a reference to the category itselfas Cat egerybui I der, 
lowing us to chain additional method calls onto an invocation of £d t Cat eger 
‘As a result we calAdsCust omtow! | on Cat egeryBui Ider, which adds a 

nen keyvale pait tobe displayed in the category. 

Using the Slate syntax, me then specifythat the row wil contain a Vertical Box with a 
singe centeralgned slot. 

Inside the slot, we create a color picker contol and bind ts One or Cosmi t ted 
delegate to our local Col or Pi ces event hander. 

Ol course, this requires us to depneand implement Co! our Picked. thas 

the folowing signature: 

Piytestontsset Detail custom zati on: Col orPickes 

(iLinesreslor Sel ectedtal ari 


Inside the implementation of Co! or Pi ced, we check to see if one of our selected 
assets mas ofthe conect type, because if atleast one selected asset was correct, 
thenilyAsset will be populated with a valid value. 

‘Assuming we have a valid asset, me set the Co or Na me property to the hex 

sting value corresponding to the color selected bythe user. 





User Interfaces - UI 
and UMG 


In this chapter, we will cover the following topics 


= Drawing using Canvas 
= Adding Slate Widgets to the screen 

^ Creating screen sieavare scaling forthe UI 

= Displaying and hiding a sheet of UMG elements ingame 
= Rtaching function calls to Slate events 

= Using Data Binding with Unreal Motion Graphics 

^ Controling widget appearance with Styles 

m Creatinga custom SW dget JUN dge: 


Introduction 


Displaying feedback to the player is one of tne most important elements within game 
design, and this will usually involve some sort of HUD, or at least menus, within your game. 


In previous versions of Unreal, there was simple HUD support, which allowed you to 
raw simple shapes and text to the screen. However, t was somewhat limited în terms 

fof aesthetics, and so, solutions such as Scaleorm became common to work around the 
imitations. Scaleformleveraged Adobe's Flash ple format to store vector images and UU 
‘scripts. t was not without its own cons for developers, though, not least the cost-it was a 
"bird party product requiring an (at times expensive) icense. 
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‘As a result, Epic developed Slate for the Unreal 4 editor and the in-game UI framework, Slate 
isa colection of widgets (Ul elements} and a framework allowing a cross-platform interface for 
the Editor. tis also usable ingame to draw widgets, such as sliders and buttons, for menus 
and HUDS. 


‘Slate uses declarative syntax to alow an iste representation of user interface elements 
in their hierarchy in native C++, It accomplishes this by making heavy use of macros and 
operator overloading. 


That said, not everybody wants to ask their programmers to design the game's HUD. One of the 
gribxart adartagss of using Scaleform within Urea 3 vas the ably to develop the visual 
appearance of game Uls using the Flash visual editor, so visual designers didn ned to leam a. 
programming language. Programmers could then insert the logic and data separately. This is the 
Same paradigm espoused bythe Windows Presentation Framework (WPF). for example. 


In a similar fashion, Unreal provides Unreal Motion Graphics (UMG). UMG is a visual editor or 
‘Slate widgets that allows you to visually stye, layout, and animate user interfaces, UI widgets 
(or controis if you've come fom a Win32 background) can have ther properties controlled by 
‘either Blueprint cade (ten in the Graph ew of the UMG window) or from Ces. This chapter 
Primarily deals with displaying Ul elements, creating widget hierarchies, and creating base 
SW aget classes that can be std and used within UMG. 
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Camas is a continuation of the simple HUD implemented within Unreal 3. While it isn't so 
commonly used within shipping games, mostly being replaced by Slate UMG, tts simple to 
use, especially when you want to draw text or shapes to the screen. Canvas drawing is stil 
used extensively by console commands used for debugging and performance analysis such 
asthestat gane andotherstat commands, Refer to Chapter 8, Integrating C++ and the 
Unreal Editor, for the recipe for creating your oum console commands, 


How to do it. 


1. Open your eds! e> bai 1 4. cs Be and uncomment add the following ine: 


Pr ivateDependencyModul enanes. Addħange(aew striagl] 4 
slates, 'statetares I 





wing using Canv 





2. Create anew Gameliode called Cust o=HUDGa neMade using the editor cass wizard. 
Refer to Chapter 4, Actors and Components, f you need a refresher on doing this. 


3. Adda constructor to the class: 
AcustomuDcemevage| 
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‘Ad the folowing to the constructor implementation: 


p bass = Aston sat cise 


‘Create a new HUD subclass called Cust o mUD, again using the wizard. 
Ad the override keyword to the following function: 


Now implement the function: 


val akcuste ri: Dri) 
i 

supers ürawibi] 

Canvae-braText| Ess) ne->Get Smal fast |). TEXTU Test 
FeareasteultenPregresstar| ector2b(S, 28] 
Festarin, S) 

Canvas- >Drani teml ProgressBar) 

Brastect| FL neartolar: lae, $, 28, 100, $) 











Compile your code, and launch the editor: 
Within the editor, open the World Settings panel from the Settings dropdown menu 
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10. in the Word Settings dialog select Cust amHüDGa ee ge fom the st under 
Game ode Override: 





11. Play an verify that your custom HUD i drawing to the screen: 


1. Athe Ui recipes here wil be using Slate for drawing so we need to adda dependency 
between our module and the Slate framework so that we can access the classes 
declared in at modile, 


2, The best place to put custom Canvas draw calls for a game HUD is inside a subclass 
oft 

3. In order to tell the engine to use our custom subclass, though, we need to create a 
nen Gamelace, and specify the type of our custom cass, 

4. Within the constructor af our custom Game Made, we assign the UCI ass for our 
nen HUD type to he HUDCI ass variable. This UCT sss s passed onto each player 


‘Controller as they spawn in, and the controller is then responsible for the AKUD 
stance hat it creates, 
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5. With our custom Game No de loading our custom HUD, we need to actually create the 
sold custom HUD class. 

6. AKUD ders a virtual function called r wHUD( which invoked in every frame to 
allow us to draw elements to the screen, 

7. Ae a result, we override that function, and perform our drawing inside the 
implementation. 

3. The prst method used is as failove: 


oat orawrent [conetuFont® Infant, const Stel ngl Tent, 
Task est Y, flea! decals = tt est Vagale = Lt 
enit Front Rengerl of obkengeri nia = Honthenderlsfoll] 














9, OrawTent requires a font to draw with, The defaut font used byst at and other HUD 
raning commands in the engine code is actually stored in the GEngi ne class, and 
‘an be accessed byusing the Get Smal 1 Font function, which retums an instance of 
theUFont asa pointer 

10. The remaining arguments that we are use are the actual tex that should be 
rendered, aswell asthe offset, in pes, at which the text shouldbe dawn. 

11 Or awText isa function that allows you to directiy pass in the data that is to be 
displayed. 

22. The general Dr awi t em function is a Visitor implementation that allows you to create 
an object that encapsulates the information about the object to be dran and reuse 
that object on multiple draw calis. 

13. In this recipe, we create an element that can be used to represent a progress bar: We 
encapsulate the required information regarding the width and height of our box into 
än FCanvas Box! tem which we then pass to the Draw! t em funcion on our Camas. 

14. The third item that we draw is a Hied rectande This function uses convenience 
methods dened in the HUD class rather tran on the Canvas itself. The Hed 
rectangle is placed at the same location as our Canvas Bax so that t can represent 
the curent value inside the progress bar, 





Adding Slate Widgets to th 





The previous recipe used the FCanvas API to draw to the screen, However, Canvas 
suffers froma number of imitations, for expe, animations are dato implement and 
drawing graphics on the screen involves creating tetures or materials. FCa nvas also doesnt 
implement anything in the way of widgets or window controls, making data entry ar other. 
forms of user input mare complex than it neede to be. This recipe wil show you how to begin 
creating HUD elements onscreen using Slate, which provides a number of bultin controis. 
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Getting ready 


‘Add ate ands at eor e to your module's dependencies if you havent done so already 
{see recipe Drawing using Camas for how to do this). 


How to do it. 
1 


reste anew?! ayer Contr al | er subclass, ACust onbUDPl ayer Central er 
(Override the egi lay virtus! method within your new subclass: 


public 
Virtual veld Beglaplayl) override: 


éd the following code for our overridden Begi nPI sy) inside the subclass’ 
Implementation: 
Vaid ACustonHUDPL ayer Cont roller: Begi Play 
t 
Super: : Begi aPl ayl) 
TSharedaet Vertical Box» widget = siew(SVert/cal Box) 
+ Serti cal Box: Slat 1) 
HAL igni Hal ign Center] 
VAL ign VAI on center) 
i 
suen(stutt on) 
content| 
i 
Shen stat al ock) 
Text (FText::FranStri ng(TEXTI Test. button*))) 
1 





engl ne- »Gamevi ewport 
SAY enpor tW dget For PI ayer | Get Local Player] 
waget, 1) 

" 

Ifyou tyto compile nov youl get some errors regarding asses not being dened. 

This is because we need to include their headers: 

#i ncl ade *slatebasi es- h" 

finci ede “Sautton t 

finci cae “STextBl ocka 


Create anew GaneMiode caled SI at eNUDGameNode: 
Add a constructor inside the Game Mode: 
Slat enuDGamedoe! | 





Chapter 





T. Implement the constructor with the folowing code: 
Aslatefuocameode: AS) at eUDCameNode() 


AGE ayer oneal eri tat 






i 


8, Ad the flowing includes to the implementation He: 








3. Ater addingthe include to the implementation je, comple your game. 
20. Within the Editor, open World Settings from the toolbar: 





1L. Inside World Settings, override the levels Game Mode to be our 
Slat eHu0Gareiode 
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12. Playthe level, and see your new UI displayed on the screen: 


How it wo 


1. In order for us to reference Slate classes ar functions in our code, our module must 
fnk with estate and SI at ecor e modules, so we add those to the module 
dependencies. 

2. We need to instantiate our UI in one of the classes that loads when the game runs, sa 
forthis recipe, we use our custom PI ayer Central er nthe Beg) n?i ay function, 
asthe piace to create our Ul 

3. Inside the segi nP! ay implementation, we create a news Ver ti calBox using 
the Stew function. We add a slot for a widget to our box, and set that slot to both 
horizontal and vertical centering. 

A. Inside the slot, which we access using square brackets, we create a button that has 
Tertel ock Rede, 

S. InTextbl oct, wesettheTert propertyto a string literal value. 

B. With the UI now created, we calladavi ewport W dget Fer PI ayer to displaythis 
widget on the lacal player's screen. 

T, With our custom PI ayer Cant rel er ready we now need to create a custom 
Gareliags ta spec that t should use our ew Pl ayer Central |r 

3 With the custom? layer Control | er being loaded at the start of the game, when 
Eegi nPI ay is called, our UI wil be shown, 


9, The Uis very small at thie screen size. Reter to the next recipe for information on how 
"o scale it appropriately for the resolution of the game window. 
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?f ou have followed the previous recipe, you will notice that when you use Play In Editor, the 
button that loads is unusually smal, 


The reason for this is UI Scaling, a system that allows you to scale the user interface based 
con the screen size. User interface elements are represented in terms of pls, usually in 
absolute terms (the button should be 10 hal tal. 


The problem with this is that f you use a higheresolution panel, 10 pies might be much 
smaller, because each pel is smaller in size. 


Getting ready 


The Ul scaling system in Ureal allows you to contol a global scale moder, which wil scale 
aM the controls on the screen based on the screen resolution. Given the earlier example, 

ou might wish to adjust the size of the buton so that its apparent size is unchanged when 
‘ening your UI on a smaller screen. This recipe shows two diferent methods for altering the 
scaling rates. 


How to do it... 


1. Create acustomPI ayer Control Ier subclass Call it 
Stali ngul Player Control ler 


2. Inside the class, override Begi sP! ay 
virtual void SegiaPlayl) override: 


3. Add the following code in the implementation af that function: 
Super: tegi nP ayt) 
TShar ehet esVerti cal 
4 sverti cal Bors: Set] 
M4 gri HA gs Center] 
gr gc Center] 
i 
Shen Satton) 
tastenil 
i 
suen(sText ect 
Teat| Flext: Fromtri agl TEXTE Test button") 





> widget = Shen SVerti cal ox) 


1 
engl e->camevievport 
PHI enpor t W aget For ayer(GetLocalPlayer|), widget, 1 





User Interfaces UL and UMG: 
4. Create a nen GaneMode subclass called zai gl GameNade, and give ita default 
constructor: 
Scal I agu Games| 


5. Within the default constructor, set the default player controler class to 
Scal gl P ayerControlier: 
Ascal i ngi Gamevoge;: Métal ng Gema | 
‘Atametodel) 
t 
Hayercontral| ertlass = 
ACHST oma ayer Control eri Stati ttl as 
+ 


6, This should give you a user interface Ike the one from the previous recipe. Note that 
the U is very tiny if you use Playin Edhar: 











17. To alter the rate at which the U scales down ar up, we need to change the scaling 
curve We cando that through two diferent methods. 
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The In-Editor method 
1. Launch Unreal, then open the Project Settings dialog through the Edit menu: 





2, Under the User Interface section, there is a curve that can be used ta alter the Ul 


‘sealing ador based onthe short dimension of your sereen: 
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3. Click on the second dat, or keypoint, on the graph 
4, Change its output value 01. 


CAC eS 


The Conbg ple method 























1. Browse to your project directory, and look inside the Conf ig folder 
"n 
pru emet] aic. ` 
prove 
Montes 
2. Open Def sul t Engine. ini inside your teit editor of choice. 
3, Find the|) Scripti Engine, User nt erf aceSett ngs] section: 
LI Seri ptitng ae, Userlatertacesettl age] 
Venterfacasiui estivi pti oot 





Det aul tcursar 



























Textsitbenntarse 
Crossbalratursor ane 

Grabhandcerser shove 

Grabhandchosedturser tone 

Slashed 

Ui Scal thul eosnoreestsi de 

Castonscal ngkai etiass sione 

Ui Sca! etur ves Edt erCarveBatae| Prel afi si tyestrapss 
ant, Postl afin tyEutrapeRCCE Constant, yrs Ti mectt 
VAIO) TI see 0.080000, Val aest 000980)" 11m 









V büttno, Yel ueni 00060), (7I mest64a. 009000, Val scd 
et aul tia ue RE EIS UA ESEBET LETS LAS LIS 
Ùi external Cur veste 









tE consi 
0, 090008, Val ues 
i 








Capers 

4. Lonk for a toy called UI Scal eCur ve in that section, 

5. Inthe value for that key youl notice a number ofi T: ne«x, Val ve=y] pals. Edit 
the second pair so that ts Ti me valueis 720. 006000 and the Vat e is 1. 000000: 

5. Restart the editor i you have it open. 

7. Start the Playin Editor preview to cortrmithat your U row remains readable at the 
PIE screen's resolution (assuming you are using a 1080p monitor so that the PIE 
window is running at T20p o thereabouts): 





8. You can also see how the scaling works if you use a New Editor Window to preview 
our game. 

3. To do so, cick on the aoa to the right ot Play on the toolbar. 

10. Select New Editor Window. 


11. Inside this window, you can use the console command r. set resi dt habel ght to 
change the resolution, and observe e changes that result rom doing sa, 


How it works. 


1. As usual, when we want to usea custom PI ayer Cent rol Ier, we need a custom 
Gameliags to specilywhich Player Cont rol | er touse, 

2. We create both, a custom?! ayer Contro! | er and Gane Woe, and place some 
Slate code in iheBegi nPI ay method ofPI ayer Control | er so that some Ul 
elements are drawn. 





my 
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3. Because the main game viewport is usualy quite small within the Unreal editor, he. 
U initially shows in a scaled-down fashion. 

44 This is intended to allow for the game UI to take up less room on smaller resolution 
splays, but can have the side effect af raking the tet very ful to read if the 
Window nt being stretched to t the full screen. 

5, Unreal stores the corbuation data that should persist between sessions, but not 
necessarily be hard-coded into the executable inside cons es. 

6, Corb bles use an extended version ofthe. i ni He format that has been commonly 
‘sed with Windows software, 

T. Corba bies store data using the folowing syntax 


[section Namel 





3. Unreal has aUserinterfaceset ti ngs class, with a property called 
UI Stal etar ve ent 


9. That UPROFERTY is marked as conbg, so Urea serializes the aluetothe. ini He. 


10. As a result, it stores the U Scale data in the Det au! tEngi ne i ni Be, inthe 
Engine. Userl sterfacesetti ngs section 

11. The data is stored using a tet format, which contains a list of key points. Editing the 
Tine, Val ue pairs alters or adds new key points to the curve. 

12. The Project Settings dialog is a simple frontend for directly editing the. | «i Hes 
yourself, and for designers, ts an intutive way to edit the cune. However, having the 
ata stored textually allows for programmers to potentially develop buid tools that 
‘modify properties such as U! Scal € without having to recompile fheir game, 

13. Ti me refers to the input value. In this case, the input value is the narrower dimension 
ofthe screen (usualy, the height) 

14. val ue is the universal scaling factor applied to the UI when the screen's narrow 
dimension s approximately the height of the value in the Ti me bold. 


15. So, to set the UI to remain normalsied at a 1280x720 resolution, set the lmelinput 
factor to 720, and the scale factor to 1. 


t You can refer to the UEA documertation for mere information regarding cons Hes 
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a sheet of UMG 





‘So me have already discussed how to add a widget to the viewport, which means that it wil be 
rendered on the player's sereen. 


However, what if we want to have Ur elements that are toggled based on ather factors, such as 
proximity to certain Actors, or a player holding a key don, or if we want a UI that disappears 
after a speciped me? 


How to do it... 


1. Create a new GameMode class caledToggl eHUDGameMode. 
2. Override eg: nPI ay andenaPi ay 
3. add the folowingPROPERTY 

inerti 





e upTegal imer 


4. Lastly ad this member variable: 
TShareaPer esVerti cal Bor» wi dge 


5. Implementéesi nPI ay with the following code in the method body: 


void ATogg! ehUDGamen 
( 
Super: : Begi Play! 
midget = Sew sVert cal Box 
P serti cal boxs: Shot 
al igni Mal ign Center 
Vani VL gh Center 




















Shen) Text el ock) 
Text rft Frente Ra TENTI Test. bettos*))] 
1 


engl ne- tame enport 
PAD ewport M dget For PI ayer Get or 
SéetFi rst Local PlayerFrentont ro e(l 
wWagetTeshareanef ll 








Get mer )- Get mer Manager (1. Set mer Hub Toggl eTi mes 
Fli merel egate:CreateLaméa 
Tenis] 
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1 
jf (ttis get ott isi beg) Ln 


thi s-on dpet oet Vis bliU tYCEVI si BL Ly: Mi dden). 





this-owidget-oserWisiallty(E¥isi b ty sel 


B. Implement ns? ay 


val ATogg|eMuDCameNade:: EndPl ay const End 
p 





{Get merRanager|) Cl earTI er HUDTagal aTi mer | 





7. Compile your code, and start the editor, 
3. Within the Editor, open World Settings from the toolbar: 





3. Inside World Settings, override the leves Game Mode o be aur 
ATogal eMUDGame Node 


10. Play the level, and very hat the U toggles its vty every seconds, 





= 








Je with most of the other recipes in this chapter, we ae using a custom Ga me Node class to 
display our single-player Ul an the players viewport for convenience: 


A 


1s 


1. 


We ovenide Begi nPI ay and nd? ay so that we can correctiy handle the timer that 
wil be toggling our Ul on and off for us. 

To make that possible, we need to store a reference to the timer as a UP ROPERT to 
ensure it wont be garbage collected. 

Within desi nPI ay, we create a new Ver ti cal ox using the Sew macro, and 
place a button in it prst siot. 

Buttons have Content, which can be some other widget to host inside them, such as 
Si mage orSText8l eck 

In this instance, we place a SText 8I oct into the Cent ent slot: The contents ofthe 
ox block are irrelevant as langas they are long enough for us to be abile to see our 
button property, 

Haning initialized our widget hierarchy: we add the root widget to the player's viewport 
So that it can be seen by them, 

Now we setup a timer to toggle the visibilty of our widget. We are using a timer to 
“simplify this recipe rather tnan having to implement user input and input bindings, 
Dut the principle is the same. 

To do this, we get a reference to the game world, and its associated timer manager 
With the Timer managerin hand, we can create a new timer. 

However we need to actually specify the code to run when the timer expires. One 
‘simple way to do this is to use a 1 ambas funcion for our toggle the hud function. 
Lambdas are anonymous functions. Think of them as iteral functions. 

To link al anba function to the timer, we need to create a ti ner delegate. 

Thet Ti mer Del egat e: : Creat eLanbda function is designed to comerta | arbda 
funcion into a delegate, which the timer can call at the specpod intenal 

The! anda needs to access thet hi s pointer from its containing object, our 
Games dso that t can change properties on the widget instance that we have 
created 

To give ithe access itneeds, we begin our! anoda declaration with the [ 

operators, which enclose variables that should be captured inta the! amb 

and accessible inside i 


The culybraces then enclose the function body in the same way they would with a 
normal function declaration. 
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17. Inside the function, we check if our widget is sible Iis visible, then we hide it 
usingS dget ii Set Visibility 

18. If the wget isnt visible, then we turn ton using the same function call 

19. Inthe rest ofthe call to Set Ti mer, we specify the interval (n seconds) to call the 
timer, and set the timer to loop. 

20. One thing we need to be careful of, though, is the possiblity of our object being 
destroyed between two timer invocations, potentially leading to a crash ifa reference 
to our objectis left dangling. 

21. In order to this, we need to remove the timer, 

22. Given that we set the timer during Begi ni ay it makes sense to clear the mor. 
uring EnePl ay 

23, End? ay wil be called whenever Ga seo either ends play ori destroyed, so we 
can safely cance the timer during is implementation 

24. With Gone ode set as the default game mode, the Ul is created when the game. 
begins to lay and the timer delegate executes every seconds to switch the visibly 
ofthe widgets betweent rue andf alse 


25. When you close the game, End? ay clears the timer reference, avoidingany 
problems 


Attaching function calls to Slate events 





While creating buttons is all well and be, at the moment, ary UI element you add to the 
player's screen just sts there without anything happening even if a user clicks on iè We don't 
have any event handlers attached to the Ste elements at the moment, so events such as 
mouse clicks dont actually cause anything to happen. 


Getting ready 


‘This recipe shows you how to attach functions to these events so that we can run custom 
code when they occur. 


How to do it... 


1. Create anew GaneMode subclass called ACI i ckeventGamelioge 


2. Add the folowingpri vat e members to the class: 
private: 
TsharedPte esVerti cal Ben» W dge 
TsharedPtr esTentBl ocio Buttonkabel 
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Fd the folowing put! c functions, noting the override forBegi aP! ayt | 


public 
Virtual vaid Bagh ePlayl) override 
Flap Butt onc! ickedt) 


Within the. cpp He, add the implementation fortegi nPI ay 
vais Ati ckEvent GaneNade: epi aPl ayl} 


( 
Super: : Begi aPl ayl) 
M aget = Siew(S¥ertical Box) 
+ Serti cal Baxs: Slat I} 
MAL igni Hal ign Center] 
VAL ign VAI ign Center) 
i 
suen(stutt on) 
"nti ckee|FOscl i cked::Cresteuob|ect( tbls 
Viti chEventGaneNsdes Rattan ches] 
Content | 
i 
Sissi gnMen(uttanLatel, STertBl act) 
Teat(FTent:FranSting(TEAT| PCI ick met*)} 
1 
1 
engines »Gamevi ewport 
SAddW enpor tW dget For Pi ayer | Get wer! dl 
Get Fi estuacal PlayerFrontont rol lert) 
Miet. Tasharedket 1, L 
Get Mori al )->Get First layer Contra! Ier | ->8Showiousecurser 
Eng ne- Get Fi rstLacal Pi ayer Controli er( Get rl a(11-> 
Seti nput edel FI aput Wodeul Only) 
Set LockMouseTaYi ewert | alsel 
Setw ager Tofocustm aget I] 
i 


o add an implementation for But t osi ckedl 


Repl ACI ck Event Gametode: But anc! ickedl) 
t 
Butt onkabel >see Text FSt ri ngl TEXTI "Cli ckedt*11): 
returnfReply::Handlef() 
i 


Compile your code, and launch the editor: 





J 
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7. Override he game mode in World Settings to becl Event Gane Node: 


3. Preven in the editor, and veritythat the Ul shows a button that changes fom Click: 
Melo Clicked! when you use the mouse cursor to click on it. 


1. As wth most of the recipes in this chapter, we use Ga me Ne de to create and display 
‘our Ui to minimize the number of classes extraneous to the point of the recipe that 
you need to create. 

2, Within our new game mode, we need to retain references to the Slate Widgets that 
we create so that we can interact with them after their creation, 

3. Ae a result, we create two shared pointers as member data within our Game No de — 
‘one to the cial parent or root widget af our UI, and the other to the label on our 
button, because were going to be changing the abel text at runtime later 

4. We override Begi nPI ay, as itis a convenient place to create our LI after the game 
has started, and we wili be able to get valid references to our player controller, 

5. We also create a function called ut tonc! i chad, Lretums FReal y.astruct 
indicating Ian event was handed, The function signature for eut t enc i cket is 
determined by the signature of F On C1 i eked, a delegate which we wil be using in a 
moment. 

5. inside our implementation of Begi nPI ay the prst thing we do is call the 
implementation we are overriding to ensure that the class initialized appropriately. 

7, Then as usual, we use our Siew function to create Ver ti ca! Box, and we add a slat 
"o it which is centered. 

B. We create a new But ton inside that slot, and we add a value to the OnCl ickes 
atiibute that tre button contains. 

3. OnI i cke is a delegate property This means thatthe Butt on will broadcast the 
OnClick es delegate anytime a certain event happens fas the name implies in this 
instance, when the button is clicked). 

10. To subsite or listen to the delegate, and be natiped af the event that it refers to, 
we need to assign a delegate instance to the property 

11. We do that using the standard delegate functions such as Creat eUOb| ect 
Creatastatic, orCreat eLamsa, Any of those wil woke can bind UO ect 
member functions, statie functions, ambdas, and ather functions. 


delegates to see abaut the ather types af function that we can bind 





Check Chapter 5, Handling Everts and Delegates, to leam more on 
to delegates. 
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Copier 
Crest eUD ect expects a pointer to a class instance, and a pointer to the member 
funcion dened in that class to cal 

The function has to have a signature that is convertible to the signature of the 
delegate: 

[09 The delegate to execute when the button is clicked "1 

Fonti  ekegon i cket: 


‘As can be seen here, DnCI i c e delegate type isFOnCI i c ked -this is why the 
but tanci i cea function that we declared has the same signature as F On C1 i cet 
By passing in a pointer to this, and the pointer to the function to invoke, the engine 
vl call that function on this specie object instance when the button is clicked, 

Ater seting up the delegate, we use the Cont ent |) function, which retums a 
reference to the single slot that the button has fr any content that it should contain. 
We then useSAssi qeu to create our button’ label, using the Text 2 oct widget 
Sissi gn New is important, because allons us to use Slate's declarative syntax and 
yet assigns variables to point to specie child widgets în the hierarchy. 

Sissi gn New brstargumentis the variable that we vart to store the widget in and 
"he second argument ts the type of that widget. 

With Butt onLabel now pointing at our button's Text BI ock, we can setts Text 
attribute to a state string. 

Finally, we add the widget to the players viewport using 

AdaVi ewport W dget For PI ayer which expects as parameters, Local PI ayer to 
‘add the widget to, the widget itself, and a depth value (higher values to the front 

To getthe Local PI ayer instance, we assume we are running without spilt screen, 
andso, the rst player cortroiler wil be the oriyone, that is, the players controler 
‘he GetFirst Local Player ronContral er funcion s a convenience function 
that simply fetches the fst player contol, and retums is local player object. 

We azo need to focus the widgets the player can click ont, and dsplaya cursor so 
that the player knows where their mouse is on the screen. 

We know fromthe previous step that we can assume the rst loca player controller is 
the one were interested in, so we can access Land change Rs ShaaNous Cursor 
variabile tot rue, This wil cause the cursor to be rendered on sereen: 

Set Input Mae allows us to focus on a widget so that the player can interact with 

it amongst other Ul-related functional, such as locking he mouse to the game's 
viewport 

"uses an input Mode object as its only parameter, which we can construct with the 
‘specie elements that we vish toindudebyusingthebu i| der pattern. 

Thet nput Mode Ul Onl y classis a FI ngut Node subclass that species that we 
want all input events to be redirected to the U layer rather than the player controller 
and other input handing 
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28. The der pattern allows us to chain the method calls to customize our object 
instance before itis sent into the function as the parameter 

29. Wechain Set LockNouseToVi export (Tal se) to spect that the player's mouse 
can leave the boundary of the game screen with Set get ToFocus| W get) 
‘which specbes our top level widget as the one that the game should direct payer 
Input 

30. Fina we have our actual implementation forBut t enc i cked, our event handler. 


31. When the function is run due to our button being clicked, we change our buttons 
label to indicate i has been clicked. 





32. We then need to retum an instance of Rez! y to the caller to let the UI framework 
knon that the event has been handed, and to not continue propagating the event 
bak up the widget hierarchy. 

33. FRepl y: : andl edt) retums FReply set up to indicate this to the framework 

34. We could have used FRep! y: : Unhand ed] ) but this would have told the 
framework that the click event wasn't actually the one me were interested in, and it 
should laok for other objects that might be interested in the event instead 


with Unreal Motion 


So far, weve been assigning static values to the attributes of our UI widgets. However, what if 
‘We wart to be rore jar with widget conker, or parameters such as border color? V cani 


à principle called data binding to dynamically nk properties of our U with variables in the 


broader program. 


Unreal uses the Attribute system to allow us to bind the value of an attribute to the 
tetum value fram a function, for example. This means that changing those variables will 
‘automatically cause the U! to change in response, according to our wishes. 


How to do it... 


1. Create a new Gamelioge subclass called At ri but eGameNode 
2. Add the folowingpri vat e member to the class: 


private: 
TsharedPte esVerti cal den» W dge 





3. Add the folowing pub! i c functions, noting the override for Begi aP! ay 
vei 


virtual void SegiaPlayl) override: 








4. Add the implementation for Begi n? ay within the. cpp He 


vol dAcli ckEvent GameMage: Bei nPI ayl | 
t 
Super: : Begi aPl ayl) 
M dget = SHewSYerti cal Box) 
+ Serti cal ions Shetl 
HAL igni Mal ign Center 
VAL igni VAL gn Center 
i 
suencsutt on) 
content| 
D 
Shen Textil ock) 
Test|_TatteibutectTent>::craate(taterigatecttext>: 
Foeteer: Crest uoo ect (thls 
Kattri bat eGo mede: Get SuttenLatel 1| 
1 
1 
engi ne- »Gamevi ewport 
SALA enpor tW dget For PI ayer | Get worl dl 
Get Fi rstLatal PayerFremtontral er(] 
Waget-Teshareaaef ll 





1 


5. Aso, add an implementation for Get But tosLabel |) 
FText ttr but eGameMode: Get Butt ontabel |) const 


t 
FvectarActorLacati os = Geter! at) 
DGetFi rst Paper Cont rol Fer) 968! Pawal ) 
Sesthctertacat ent] 
retarnfrent. Fransteiag 
FH 
Atteilocntien. X, Actorkoration.Y, ActorLoration. ZI): 

è 


6. Compile your code, and launch the editor: 
7. Override the game mode in World Settings to be AAt ri but eGane Hode- 


B. Note that in a Playin Edtor session, the value on the UIS button changes as the 
player moves around the scene. 





stringent, W 








1. Just like almost al ather recipes in this chapter, the rst thing ve need ta do is create 
a game made as a convenient host for our Ul We create the Ulin the same fashion 
asin the ather recipes, by placing at code inside the Begi nPI aj] ] method of 
our game mode. 


2, The interesting feature of this recipe concerns how we set the value of our buttons 
label text: 


Text} 
TAttrsputectTexts::createlratte|autectrent: Faetter: creat 
Mn etti tis: bI buteGameMode Get Buteencabel ||) 





3. The precedingsyntaxisunusualy verbose, but what iis actualy doing s 
comparatively simple. We assign something tothe Tex: property, which is af the type 
Tent. We ean assign Tat tri aut e«t Text » to ths property andthe Tat tri bute 
Get [I method wl be caled whenever the Ui wants to ensure that the value of Te 
i up to date. 

4, TocreateTattr i bute, we need to calle stai TAL ri Aut e<Vari abl eType>: 
Create!) method 

5. This function expects a delegate of some description. Depending on the type of 
delegate passedtoTAttri but ez Create, TR tr bate: Get] imekesa. 
different tpe f function to retrieve the actual value. 

6. Inthe code for this recipe, we invoke a member function of Ub ec t. This means we 
‘nou we wil be caling the Crest eU0bj ect function on some delegate type. 


Wecanusetreatelambda,Creat estati c,orCreat eaw to eine 
EÓ alamtdasastat icsora minber function respectiælyon a raw C++ 
ass Thi wil gve us tha curent value for the atte, 





7. But what delegate pe do we wart to create an instance of? Because were 
templating the TAt tri bute class on the actual variable be that the atribute wil 
be associated with, we need a delegate that is also templated on the variable type as 
its retum value. 

8, That isto say if we have TAt tri but ecF Text >, the delegate connected o it needs 
ta returnan tert 


-gnj 








2 


Wo have the folowing code within Atti but e 
temp atectypenameddj eci Type» 
claseTaterl ute 
( 

public 


+ Attribute getter" delegate 


object TypeGetval eel) cons 


* aretara The attribute's value 
DECLARE DELEGATE. RetVal Object Type, Foetter) 
[E] 

, 


Thet Get ter delegate type is declared inside theTAt tri but e class, so its 
retum value can be templated on the Obj ect Type parameter oftheTAt tti but e 
template. 

This means at Tt tri bute<Typename>: : FGet ter automaticaly 

defnes a delegate with the correct retum type of T y pena se. 

So we need to create a UO ect -bound delegate of type and signature for 
ThetributectText >: Fetter 

Once we have that delegate, we can callTAt tri but e:: Create on the delegate to 
link the delegate retum value to our ext lack member variable Text 

"Mh our Ui detned and a binding between the Te vt property, a 

Tattri but ecfText >, and a delegate retuming F Text , we can now add the UI to 
the players screen so that its vibe 

Every fame, the game engine checks all properties to see if they are linked 
ferte bites 

there's a connection, then the tt ri bute Get function is called, invoking the 
delecte, and returning the delegates retum value so that Slate can store it inside 
the widgets corresponding member variabile. 

For our demonstration of the process, Get But tont abel retrieves the 

location of the prst player pan in the game werid. 

We then useFStr ing: Print! to format the location data into a human readable 
string, and wrap that nan Text so thatit can be stared as theText B! ock tet 
nue 
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ontrolling wid rance with 





So far in this chapter, weve been creating U elements that use the default suat 
representation. This recipe shows you how to create a Style in C++ that can be used as a 
‘common look-and-feel across your whole project 


How to do it... 


1l. Create a newclass headerin your project Name the le * Cookbook yl e. 
2. Ad the flowing code tothe le: 
pragma on 
inci ade “slatebasi es- ht 
finci ade cilatetrt ras M 
ss#Coukboukstyle 








static veld Shut dowel 

Statie vold felaedvestures() 

staticcanstislatestylek Get) 

Stat icENameGet Styl eset Namel) 

fslatestyl 
i 


3. Create a corresponding irplemertation cpp He for this caes, and add the 

folloing code to it: 

me 

tcl ede “Cookboorstyi e. N 

finci ede “SlateGanehaseurces. N 

har aePtrcfSiatestyi eSetFCookbookStyl e:: CookbookStyl el nsi 

vel dFCookb 
( 

t D Caakbookstyl el est ante. sal] 





Sharedhat elass Fslatestyl eset» createl 




















kstylesteitialisell 


Caokbookstyletnstance  Crestell 
latastyi eneglstey: Registers atestyl e 
M tookbookStylelnstancel 











' 


vel dFcookbookstyl e::Shutdoun() 
t 
Fslatestyl ehegi stry: Untegi sterstatestyl e 
I*cooknookst ylei nstancel 
ensurel Cookbookstyl el nst ance. Isai quel) 
Cootboatstyl elastance. Reset] 
] 
FNametCookbookStyl e: GetSt yl eSernamel) 
t 
stati cPlamest jl eset Namel TEXTI "CookbookSt yl e*I) 
Fetarnstyl eset Hane: 
i 
#detine IMAGE BRUSH Rel t vet, ss] Slate! mageBrushi 
FoathessGanecontestOe|)\) Slater] RelativePath 4 
TOT pni. VA ARGS. | 
séefl ne Box BAIN Gel ativePatn, ... ) FSIatetorBrush( 
Fraths!:GangCententDiei)") *Slate') RelativePath + 
TEC pri. MARG | 
#defi ne BORDER GRUGM( Relat ivePath, ss. | Filateloréerbrushl 
Fraths!:GameCeatentDiel) ) "Slated AelativePath + 
TET pni. CAIRO, | 
retire TTE FOWT( Gl ativerath sss | PSlatefontintol 
fitis cumicontenrbi rl) J Slate) Belati vePath + 
TEC t. D ARGS. | 
retire OTF FONT(ARIativaPath, ... | FSlatefont/ fel 
PritistsGumicntenrbi rl) J Slate] Reati vePath + 
TET otf", -VAARGS. | 


‘shar edeteF51steStyl eSet>FCookbookStyl e: :Createl) 


‘ TSharedRef «FSl at eSt yl eSetoStyleRef = 
Talateeeeherov cet n 
Tettenticiec citet ml, *sGasersiate 
‘team sate!) 
{Statestyeseth Style = Styl etet. Ge 
Sigla Sed orma but tonarash 
Puttane en) 
Set tr ont (Bx Bush autron" 
ertt tesi) aste irse 
Siya Set lormittantit 
Fabel sekst piel tea acest yle: atest 
fete ranatpty Pieter Parker IIT 
sternit etat 
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sendet IMAGE BRUSH 
mr 
findet gOMDER, BRUSK 
tender TTE Foi 
finde! ori FONT 


val dFcookbookstyl e: Rel oadTexturest | 
( 
Fslateagpl cations Get) et Renderer() 
hel adtertureesoerces]| 
] 
consti Slat esty eUFCookbookstyl i Get() 
t 
return "Cootbootstyi elastance: 
, 


4. Create a new Game Mode subclass, sty! e4MUDGame ose, and add the 
folowing code to its declaration: 
fteragm once 
f tcl ude" Gamefcameuor ti GaneMode. N 
tcl ede “Sty! egHUDGanedoge. generated. n" 


ucussi) 
class UEACOOKBOOK_APL AStyIedHUDGameNode : public AGanekode 
t 


ceneraTen eony) 
TsharedPt r «serti cal Box» W dget: 
public 
Yirtual void MegiaPlay() override 
I 


5. Likewise, implement Ga meMode 
#i ncl ade *UEaCookBook. h" 
tcl de “Cookbookstyi e. 
#i nci ude “Styl edhUDGameNode. b+ 
Vai dAStyl etie mode: Begin ay 
t 
Super: Beg) aPl ayl) 
M dget = Sew SVerti cal Box) 
+ Serti cal Bons Slot] 
HAL igni Mal n Center 
VAL igni VAL gn Center 
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Suttanstyl el fCoatboakstyl ei: Get) 
‘Normal But tenarus® 
Content ada agl Par gi nl 161| 
i 
Shen Testi ock) 
Tertstyl el F£entbenl tjl ei: Get(), “Normal butterTert*l 
Testi Text i Fronstr ingl Styled Butter) 
1 
1 
engl ne-»Gamevi evpart 
SAY enpart get orP/ayer( Get or 
Sáetri rettatsl Playerbrontentral ler) 
1 


5. Lastly create a 54354 phe pr Be vith a border around for our button: Save tto 
theContent | slate folder withthe name ut ton. ng 


























7. Finally we need to set our game's module to properly ital the style when itis 
loaded. In your game madude'sirrplementation He, ensure it looks ike this: 





Class UEACookboakGamedodule | publie Foetal tGaneNedul el mp! 
t 

virtus volé startuplodalal) override 

1 


fF oakbookstyl eile tial ise 
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ay 


virtual volé Shut downNedule() override 
1 
Foakbookstyl ei: Shutdown) 
D 
H 


Compile code, and set your game mede override to the new game made as weve 
done inthe other recipes this chapter 


When you play the game, you wil see that your custom border is around the button, 
and the textis white rather than black- 


it 





In order far us to create styles that can be shared across multiple Ste widgets, 
We need to create an object to contain the styles and keep them in scope. 

Ep provides the FSi at eSt yl eset class for this purpose. FSI at eSt y| eset 
Contains a numberof styles that we can access within Slate's declarative stax to 
skin widgets. 

However, its inefpcient to have multiple copies af ourst y! eset object scattered 
‘through the program. We realy only need one of these objects. 
Because SI atesty! eSet itself is nota singleton, that is, an object 

that can oniy have one instance, we need to create a class that wil manage our 
Styl eSet object and ensure tat we oniy have the single instance. 

This is the reason we have the FContbookSt y| e clas. 

‘contains an! ni ti at izel ) function, which we will call in our module's startup 
code. 
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7. Inthe! ni ti al izel) function, we check if we have an instance of our St y! ese 


3. If we do not havea valid instance, we call the private Cr eate) function to 
instantiate one, 


9. We then register the style with the SI at eSt y! eRegi stry cass. 


10. When our module is unloaded, we wil need to reverse this registration 
Process, then erase the poiner so t does not dangle. 


21. We now have an instance of our class, created during module initialization by 
calingCreatet) 


12. Youl notice that Cr eat e is wrapped bya number af macros that all have similar 
fom. 


13. These maces are defned before the function, and undepned after it 


14. These macros make it easier for us to simply the code required within the 
Creat function by eliminating the need ta specifya path and extension for all the 
image resources that our Style might want use. 


15. Within the Creat e function, we create a new FSI at e$t I eset object using the 
unctionFSI at eGaneResources:: New) 


16. New ) needs a name for the style, and the folder paths that we want to search for in 
this Style Set. 


17. This allows us to declare multiple Style Sets pointing to different directories, 
but using the same names for the images. als allows us to skin or rese the 
hole UI simply by switching to a Se Setin one of the other base directories. 


38. ew) retums a shared reference object, so we retrieve the actual 
Styl eset instance usingthe Get] function. 


19. With this reference in hand, we can create the styles we want this setto 
contain. 


20. To add styles to a set, we use the Set (| method. 
21. Setexpects the name of the style, and then a style object. 
22. Style objects can be customized using the bsi 1 der pattern: 
23. We prst add a she called" Nor mal But t onBr us h" The name can be arbitrary: 
24. Because we want to use this style to change the appearance of buttons, we 
need to use FBut tont y e for the second parameter 
25. To customize the style to our requirements, we use the Slate builder syntax, 
chaining whatever method calis that we need lo set properties on ou se, 
26. For the pst she inthis set, ve just change the visual appearance of the button when. 
È isn't being clicked oris in a sondefaut state. 


27. That means we want to change the brush used when the button is in the normal 
state, and so the function we use is Set Nor mal |) 
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28. Using the SOL. BRUSH macro, we tell Slate that we want to use Eat tan. png, which 
isan mage of'54354 pisse, and that we want ta keep the 14 pal in each 
omer unstretched or the purposes of nine-slice scaling. 


Fora more visual explanation afthe rine sce scaling functionality. 
{ate alook stil at eBov8rush. h in We engine source 


29. Far the second style in our Style Set, we create a style called" Nor mal ButtonText * 
Far this style, we dont want to change everything from defauts in the style; we just 
want to alter one property 

30. Asa result, we access the default te style, and clone it using the copy 
constructor 

731. With our fresh copy of the default syle, we then change the color of the teat 
to white, hrst creating a linear color af Re Gel Sel Ad, then comertingthat toa 
Sate color object. 

32 Mth our Style Set conte with our two naw tes, we can then retum tto 
"he calingfunction, which isi ni tial ze 

33. ni ti al i ze stores our Style Set reference, and eliminates the need for us to create 
further instances, 

34. Our style container class also has a Get || function, which is used to retrieve 
the actual t y eset for use in Slate. 

35. Because! ai ti al i zel ) has already been called at the module startup, 

Get |) simplyretums the Sty eSet instance that was created within that function, 

36. Within the game module, we add the code which actuallcals ni tiati ze 
and Shu! gown, This ensures that whle our module i loaded, we will alaye have a 
valid reference to our Slate Style, 

37. As always, we create a Game Mode as the host far our UI, and we override 
Bagi nPI ay so that we can create he U when the game starts, 

38. The syntax for creating the U is esactiy the same as we've used in previous recipes— 
creatinga ver ti cal Sox usingSNeu, and then using Slates declarative syntatto 
populate the box with other widgets. 

39. Itis important to note the two following Iines: 

ButtonStylelFCootbootStyle:: Get(), “Normal Buttont 
TextStylelFCovkbovkStple::Get(], “Normal BettosTe 





40. The preceding Ines are part of the declarative syntax for our button, and the. 
tes that makes its label 


41. When me set the style for our widgets usinga «t! ass>5t yl e() method, we pass in 
‘wo parameters, 
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42. The prst parameter is our actual Style Set, retrieved using 
FCookbonkSt yl e: Get |) ,and the second is a string parameter with the name of 
the style that we want to use 

43. Wit these minor changes, we override the styling of the widgets to use our custom 
styles so that when we add the widgets to the player's viewport, they display our 
Customizations, 


E 





The recipes in this chapter so far have shown you how to create UIs using the exiting 
primite widgets, 


‘Sometimes, itis convenient or developers to use composition to collect a number af Ut 
‘lems together, for earrpie, to depne a button class that automaticallyhas aText B! ock 
(2s a label rather than manually specifying the hierarchy every time they are declared. 


Furthermore, if you are manually specifying the hierarchy in C+, rather than declaring 
compound object consisting of subwidgets, you won't be able to instantiate those widgets as a 
group using UMG. 


Getting ready 


Tris recipe shows you how to create a compound SW dget that contains a group of widgets 
and exposes new properties to control elements of those subidos wl also show you how 
to create att dget wrapper, which wil expose the new compound Swi pet class to UMG 
for use by designers. 


How to do it... 
1 


We need to add the UMG module to cur modules dependencies. 
Open up <Your Modal e>. bui Hd. cs, and add UMG to the following 


Pr ivateDependencyMedul enanes. AddRange(new stringl] | 
slates, *statecares, "UNG" J) 


3. Create a new class called Cust ondutt on, and add the folowing code to its 
declaration: 


toragm once 
#i nci ude "SConpousdM dget- h" 
lass UEACOOKBOOK_API SCustondatton : public 
Scompoundi dget 
( 

SLATE BEGI IL ARGSI Cost umbutt 
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Label TEXTE Default Value) 
Died icedli 
n 
SLATE_ATTALBUTE|FSteing, Label 
SLATE EVEAT|Foncli ceed, Buttont i chad) 
SLATE_END_ARES(| 
minii 
ald Constract const Far gunent ski args 
Tater dutectSteing> Label 
Foncli ceedaattastl i ched 
I 


4. mrplerrert tho dass with the following inthe corespending cpp He: 
#i ncl ade *UEdCookbook. h" 
finci ede “Cust ondutter. ht 
VoldScustomBut ton: Coostract| const FArgunent sb aar gsl 
t 
Label = Ladrgs. Label 
Buttonci chat = lnarge. „Buttont chee 
Chis Asl at. YALI gal VAL ign” Center 
HAL ign MAI i gn Center] 
isuen sutton) 
inci cues ute enti ches] 
Castent|) 
i 
Shen stent lack) 
Tert Lambal [tèis] freturn 
Henti: renstri sel Label Gets I 
1 
1 








y 
5. Create a second class, this time based on Ui dget „caled 
Ucust omaat tonm dget 
6. Add the following includes: 
#i ncl ade “Coneonente/ M dget 
finci sde “Custonðstton. nt 
finci ade *SlateDel egat esa" 
7. Declare the folowing delegates before the class declaration: 


DECLARE DTI C DELEGATE RetVal |FString, FGetstringl 
DECLARE DIAN C NULTI CASŤ,DELEGATEL Flut tonii ched) 


-gnj 








x. 


‘ad the following protected members: 
protected 

Tsharedtr<Scestantuttonsmyaut ton: 

virtual TSbareater «SU dget Rebus LAWE dget |) override: 


Aiso add the following public members: 
public 

cust imbutter dget) 
UPROPERTYI vepri ot Assignable) 
Fauttoncl  ckeabutt oni ches 
Repl pontettostii ced) 
UPROPERTY(Bivepri atReadWrite, Edi tAngwnere) 
Fstriag Label 

nori 

Fat StringLabel Delegate: 

virtual vaid SynchronizePropertlesi] override 











Now create the implementation fr UCust anBut ton aget 
#i ncl ade “UEACookBonk. ht 
finci ade “customer tomi dget. N 
Tsharedhet SW dgetUCustombutt ont dget: Rebull am dget (1 
( 
Wüsttos = shew) SCusteriuttoe] 
Buttont i cted( 8I 1D. UOBJ ECT, OELEGKTELFonCI | ced 
andettosct vedi) 
retaraNyButt on. TeSharedRet() 
i 
Ucust endut toni dget: UCust omdut toni dget () 
Label TEXTE" Default Vale] 
] 
i 





Repl pltustonbutt ent dget: OnButtascl i cheat 
t 
Buttont ches. Broadeasti| 
FetarnFRepl yi Handi edl) 
] 
‘vel ducustomBut toni dget: :Synchroni zePraperė eel] 
t 
Super: : Synchroni zeProperti esi | 
TattribwtecFStri patei Bi ndi ng = 
OPTi omat Bl Nc Est ring, Label) 
WyBettonsoLatel = Label Bindi ag: 
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11. Create a nen Widget Blueprint by right licng on the Content Browser, selecting 
User Interface, and then Widget Blueprint 


12. Open your new Widget Blueprint by double-clicking on it- 
23. Find the Custom Button Widget in the Widget Palette: 
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u. 
as 


a 


1s 


2. 


Dragan instanceof it out into the main area. 
With the instance selected, change the Label property the Details panel 





Veritythat your button has changed is label. 





Now we vili create a binding to demonstrate that we can link arbitrary blueprint 
functions to the label property on our widget, which, in tum, drives the Widget’ 
textloce labe! 


‘Click on Bind to the right of the Label property, and select Create Binding: 





Link the retum value from the Get Game Time node to the Retum Value pin 
în the funcion 
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21. Aconert oat to string node wil be automraticallyinserted far you: 





22. Nent, open the Level Blueprints by clicking on the Blu 
"hen selecting Open Level Blueprint: 





ints button on the taskbar, 








23. Place a construct widget node into the graph: 
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24. Select the cass of widget to spawn as the new Widget Blueprint that we created a 
moment ago within the editor: 








25. Click and drag away om the Owning Player pin on the create widget nod 
place a Get Player Controller node: 











26. Likewise, dag away from the reum value of the create widget node, and place a Add 
to Viewport node. 
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27 Lastly lnk the Begi nPI ay node to the execution pin on the create widget node. 


28. Preview yaur game, and verify that the widget we've displayed onscreen is our new 
Custom button with e label Bound to the number al seconds that have elapsed since 
the game started: 


1. Inorderto use the Widget cass, our module needs to include the UMG module as 
one ofits dependencies, because Ui dget is dened inside the UMG module. 


2. The prst dass that we need to create, however, is our actuals et. class. 


3. Because we want to aggregate two widgets together Into a compound 
structure, we create our new widget as a Compound dget subclass. 


4. Compound aget allows you to encapsulate a widget hierarchy as a widget 
p 


5. Inside the class, we use the LATE, BEGI N, ARGS and SLATE, ENDL ARGS 
macros to declare an intemal str utt called Ar puente on our new SW dget 

B. Within SLATE BECI N, ARGS and SLATE, END, ARGS, the SLATE 
ATTRIBUTE and SLATE, EVENT macros ae ied, 


T. SLATE ATTRIBUTE creates TAt tri bute for the type we ghe it- 
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8, In this class, we declare Tat tri bute called, Label , whichis more specibcallya 
Thetributect String>, 

9. SLATE EVENT allons us to create member delegates that we can broadcast when 
something happens internally to the widget. 

30. In5Cust osut ton, we declare a delegate with the signature FOn C i cked 
called But tonchi eked. 

1L SLATE, ARGUMENT is another macro, unused in this recipe, which creates an 
intemal variable with the type and name you provide, appending an underscore to the 
Start of the variable name 

22. Const uct is the function that widgets implement to selintialze when 
they are being instantiated. 

13. Youl notice we also create aTAt tr i but e anda FOaCli cked instance ourselves, 
without the underscores. These are the actual properties of our object into which the 
arguments that we declared eaier will be copied. 

14. Inside the implementation of Const r uct , we retrieve the arguments that 
were passed to usin the Far gument sst r uct ,and store them inside our actual 
member variables for this instance. 

15. We assignLabel and But tanci i c ted based on what was passed in, then we 
actually create our widget hierarchy 

16. We use the same syntax as usual for this with one thing to note, namely, the 
use of Tert -Lambda to set the tex value of our intemal tent Bock 

37, We use al ambaa function to retrieve the value of our Label Tit tri but e using 
Get) then convertito FT ext and store itas our tex block's Text property. 

18. Now that we have our sii get declared, we need to create a wrapper 
Lit get object that wil expose this widget to the UMG system so that designers can 
use the widget within the WYSIWYG editor. 

19. Tis clas willbe called UCust enbut t onii dget, and it inherits from. 

UW dget rather han SM dget 

20. he U dget object needs a reference to the actuals dget thatit owns, 
so we place a protected member inte class that wil store ias a shared pointer 

21. A constructor is declared, so is a But tenCl i cked delegate that 
can be setin blueprint. We also miror a Label property that is marked as 
Blueprint Rendite so thatit can be set in the UMG editor 

22. Because we want to be able to bind our buttons label to a delegate, we add the last 
of our member variables, which is a delegate that retums a Stri ng 

23. TheSynchr oni zePr oper ti es function apples properties that have been mirrored 
ingur Uwi dget class across tothe SW eget hat we are linked with. 





J 
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E) 


25 


a. 


2. 


28 


z. 


20. 


a. 


2. 


Rebui HW aget reconstructs the native widget this UN dget is associated wih 
"uses stew to construct an instance of our SCust onbot ton widget, and uses the 
‘Slate declarative syntax to bind the Uhldgets On Butt on C! ced method to the 
Butt ancl cied delegate inside the native widget. 

This means that when the native widget is clicked, Ihe UI dget willbe 

mated byhaingOn Butt onClick called. 

Onguttoncl i cked rebroadcast the clicked event from the native button via the 
widgets Bst tonc i eked delegate. 

“This means that UObjects and the UMG system can be notiped af the button 

being clicked without having a reference to the native button widget themselves, We 
can bind toUCus t ost toni dget :: Butt onCI i cked to benatiped aboutit 
nut tonc i cked then retums F Repl y: : Handled] to indicate thatthe 

event does not need to propagate further. 

Inside Syachr oni zePr aper ti es, we call the parent method to ensure 

that any properties in the parent are also synchronized property. 

We use the OPTI QUAL £I NDI NG macro to link the Label De! egat e delegate in our 
UMK aget class to Tat Er i but e, and in tum, the native buttons abel Is important 
to note thatthe OPTI ONAL 8I NDI NG macro expects the delegate to be called 
Namede! agate based onthe second parameter to the macro. 

OPTIONAL. i NDI KG allows for the value to be overridden bya binding 

made va UMG, but oniyif the UMG binding is walid. 

This means that when UW aget i told to update itself, for example, 

because the user customizes a value in the Details panel within UMG, i wil recreate 
"he native SW aget if necessary, then copy the values set in Blueprint UMG via 
Synchrani zePropert i es so that everything continues to work as expected. 
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Al for Controlling NPCs 


The ole of Artipcial Intelligence (A1) in your game is quite important: In this chapter, 
we'l cover the folowing recipes for controling yout NPC characters wh a bit of A: 

‘Laying down a Navigation Mesh 

= Following behavior 

= Connecting Behavior Tree to a Character 

= Constructing Task nodes 

= Using Decorators for conditions 

= Using periodic services 

Using Composite nodes - Selectors, Sequences, and Simple Parallel 

^ Nera Melee Attacker 


Introduction 


A includes many aspects of a game's NPC as well as player behavior. The general topic of AI 
includes pathpncing and NPC behavior Generally we term the selection of what the NPC does 
for a period of ime within the game as behavior. 


Ain UEA is well supported. A number of constructs est to allow basic Al programming 
from within the editor. f the AI provided inside the engine doesn’ sut your needs, custom Al 
programming fom C++ can also be used. 








for Cerraling NPC — 


Laying down a Nav 





A Navigation Mesh (also known as a Nav Mesh) is bascallyadebrion of areas that an A 
Controlled unt considers passabe (hat, areas which the Accontoie unii allowed to 
mave into or across). A Nav Mesh does nat include geometry that would block the player the 
player riedi to move through t 


Getting ready 


Constructing à Nav Mesh based on your scene's geometry is faily easy in UEA. Start with a 
project that has some obstacles around t ar one that uses a terrain. 


How to do it... 


To construct your Nav Mesh, simply perform the following steps: 


1. Goto Modes | volumes, 
2. Drag Nav Mesh Bounds Volume onto your viewport. 


[ 


3. Scilethe Nav Mesh out to cover the area thatthe actors that use the Nav Mesh 
Should be allone to navigate and pathindn 


How it works. 


A Nav Mesh doesnt block the player pawn (or other entities) rom stepping on certain 
geometry, but it serves to guide A contolld entities regarding where they can and cannot qo. 


Following behavior 


The mast basic Akcontrolled follow behavior s available as a simple function node. Al you have 
"o dois perform the steps that falow to get one A control unto follow a unit ar object 





este het verre ] 
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Getting ready 


Have a UEA project ready with a simple landscape or set of geometry on the ground ideally. 
vith a culdesac somewhere in the geometry far testing out Al movement functions, Create 

2 Nav Mesh over this geometry so that the AI MoveTa function will work as described in the 
previous recipe. 


How to do it.. 


1 


Create a Nav Mesh for your levels geometry as described in the preceding recipe, 
Laying down a Navigation Mesh. 


Create a Blueprint class derling fem Character byþndingtheCharact er class in 
theClass Viewer, right clicking on it, and selecting Create Blueprint Clas 


Name your Blueprint class 8 








Fall owe 
Double-click on thea? Foil over class to edits Blueprint 


Inthe ck event addam Al HoveTe node, which moves tad the player pawn (or 
any other unit) as follows: 





The 4i MaveTo node wil automatically use a Nav Mesh fone is available. a Nav Mesh is not 
available, then Ihe NPC unit went move. 
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There's more. 


Ifyou do not want the unit to move wth pairing using the Nav Mesh then simply usea 
Move Ta Location ar Acta node, 





[AMove To Location or Actor node works even without a Nav Mesh on the geometry. 





Conne to a Character 





ing a B 


Atehavi orTree chooses a behavior to be exhibited by an ALconrlled unit at any given 
momentin tme. Behavior Trees are relatively simple to construct, but there sa lot of setting 
up to do ta get one munning. You aleo have tn be familiar with the components available for 
constructing your Behavior Tree to da so effectively. 


vior Tr 








A Behavior Tree is edrerely useful for ding NPC behavior thats more varied than simpy 
moving towards an opponent (as shown in the previous recipe wth A| ave 


Getting ready 


The process af setting up a Behavior Tree to control a character is fairly complicated. The 
Prst thing we needis a Blueprintof aChar act er class derivative to conto We Ihen need 
to create a custom A Controller abject that wil runout Behavior Tree to control our Melee 
attacker character. The! Contra ler class Inside our Blueprint wil pun our Behavior Tree. 
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BP_MeleeAttacker 
DX 


Bonaviortros 











The Behavior Tree itself contains a very important data structure called a Blackboard. The 
Blackboard is like a chalkboard for containing variable values for the Behavior Tree. 


A Behavior Tree hosts six different types of node, which are as follows: 


1, Task: Task nodes are the purple nodes in the Behavior Te that contain Blueprint 
ode to run. tts something thatthe A-contralled unt has W do (code-wise]. Tasks 
must retum either t1 ue ortal se, depending on whether the task succeeded or not 
(by providing Fi ri shévecuti on} | node at the end). 


0 l 





2. Decorator: A decorator is justa Boolean condition for the execution af a node. 
It checks a condition, and is typically used within a Selector or Sequence black. 


+ 
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3. Service: Runs some Blueprint code when it ticks. The tick interval fr these nodes is 
Adjustable can run slower than a peram tick, for example, every 10 seconds), You 
‘an use these to query the scene for updates, or a nem opponent to chase, or things 
We that The Blackboard can be used to store queried information. Service nodes do 
nothaveaFi ni shéxzcut e| callat the end. There is an example Service node in 
the Sequence node in the preceding diagram. 


4. Selector Runs all subtrees fram left to right until it encounters a success. When it 
encounters a success, execution retums back up the tee. 


5. Sequence: Runs subtrees from left to right until t encounters a failure. When a 
failure is encountered, eecution goes back up the tree. 

















Sector ades attempt to ect nodes unti success er 
sien reine le Squece noses eee al ures a re 
E encounters lanar ch retums! 

SES Keepin mind ihat t your Tasks do votca F: ni shërecutet 
nether eta o Sequences wi be able to run more than ore 
of tnem in succession, 


‘Simple Parallel: Runs a single task (purple) in parallel with a subtree (ray. 


= simple Parallel 


i 3 


PlaySound Cone check 


1 Sequence 
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How to do it. 


1 


Begin by creating Blueprint for your Melee unit inside UE. You should do so by 

derling a custom Blueprint Irom Character Toda so, go to the Class Viewer, pe 

Character. and eghtelek, Select Create Blueprint.. fom the conte menu that 

appears and name your Blueprint class 3? Wel eeCharacte 

To use a Behavior Tree, we need to start by setting up a custom A Controller for our 
haract er caes derivative. Go to Content Browser and derive a Blueprint ram the 

Ai Contr al ler class-be sure to turn ofl Filters | Actors only prst! 








Nor-actor class derivatives are nat shown by defaut in the Class Viewer! 
Tomake nel Cont ral er class shou, you need to go to the Filters 
menu and uncheck the Actors only menu pan 





‘Create your Behavior Tree and Blackboard objects byrigħtelicking in Content 
Browser and selecting Artipcial Inteligence | Behavior Tee and Artipcial 
intelligence | Blackboard. 

Open the Behavior Tree object, and under Blackboard Asset in the Detalls panel, 
select the Blackboard that youe created Blackboards contain keys and values 
(named variables) for your Behavior Tree to use. 





Open your BAI Mel eeCantrol Ier class derivative and go to the Event Graph 
Under Event BeginPlay. select and add a Run Behavior Tree node t the graph. 
UnderāTAsset besute to select yourBehavi arTrae_FFA Mel eeAttacter asset 
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A Behavior Tree is connected to an A Controller, which in turn is connected to a Blueprint at a 
‘Character, We will contral the behavior of Char act er tough the Behavior Tree by entering 
Task and Service nodes a Ihe diagram. 


onstructing Task nodes 


Task nodes are like function blocks, Each Task node you construct will allow you to bundle up 
some Blueprint code for execution when certain conditons in your Behavior Tree are met. 


Tasks have three distinct events: Receive Tick (with Al version), Receive Execute (A and 
Receive Abor (A You can respond to any of these three events inthe Tack’ Blueprint. 
Usualy you shouid respond to the Receive Execute (Al version) af the Task. 


Getting ready 


To create a Task node, you should already have a Behavior Tree ready and attached toan 
appropriate A Controller and Blueprint Character (see previous recipe) 


How to do it.. 


1. To construct a Task node with an executable Blueprint code inside it, you must 
elect New Task fem the menu bar from our Behavior Tree Blueprint edit From 
the dropdown menu that appears, select to base your New Task on BTTas_ 
Blueprint tase 





) Unike Behavior Tre or Blackboard creation, there ent way ta create 
|. a New Task cect rom he Content Browser. 
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2. Doublecick and open the Behavior Tree task that youve just created to edit 
Override any of the aalble events (isted in the Functions subheading under the 
My Blueprint tab 


1. Recelve Tick Al: The AI version ofthe Ti ck event far the Behavior Tree Task 
You should verde this function when you need your task toT ck wih the 
actor that contains i. Do not override this function if you only want your task 
to precute when itis caled by the Behavior Tree [not when the game engine 
teks) 


2. Recehe Execute Al: The main function that you want to override. Receive 
Execute A allows you to run some Blueprint code whenever the Task node is 
invoked from the Behavior Tree diagram. 





3. Receive Abort Al An abortion on a Behavior Tree task is called when 
the task is being aborted (bya 7! ti shabar t|) nade cali frm the 
Blueprints diagram). 


gl There are non-A versions af the preceding functions, which have just 
Uy ostevsssines niet venion, ie amer oberts cast asa 
Pawn, and there isan Dune Controler passed ang the event call, 


ditions 





Decorators are nodes that alou you to enter a cantonal expression on evaluation of 
another ode. They are fairly oddly named, but they are called Decorators because they 
tend to dress up execution nodes with conditons for emecution. For example. in the following 


diagram, the MoveTo function is only eecuted when the Decorators condition is met: 





There are several pre-packaged Decorators that come with UEA, including Blackboard 
triable checks), Compare Blackboard Entries, Cone Check, ooidown, Does Path Exist, 
and so on. In this recipe, we explore the use of some of these conditional to control the 
‘recon of different branches of a Behavior Tree 





my- 
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Getting ready 


“he abiltyto create a Decorator is oniy available rom the menu bar of an esting 
Behavior Tree. 





soto Indi ou met have an esting Behavior Tree apen: 


[ Vg Bete erent ne eu nai tare ] 


1 


Inthe Menu bar atan existing Behavior Tre, select New Decorator. Base it on the 
esting Blueprint, STDecaratar Bl uepri at Base, 

‘Assemble your Blueprints diagram determining whether or not the Decorators 
condition is successful under he Perf or cent: tv onChect function override. 











Intemals of a Decorator checking f the follow target from the Blackboard is inside 
a bounding sphere of certain rais, Return t rae ifthe Decorators condition & 

met [and the block dependent on the Decorator executes), or retum fs se Ifthe 
Decorators condition is nat met (and the block dependent on the Decorator doesnot 
excite 
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Decorators are just Ikei £ statements; the only teen 
iecit the node direct beneath them in a Behavior Tree. 





that they place a condition to 


Usin iodic 





vic 





pi 


Services are nodes that contain Blu 
u 


rint code to be executed periodically Services area lot 
Tasks, but they donot havea Fini sherecut2( | calltthe end 


Getting ready 


‘ing Services to your Behavior Tree is essential fer periodic checks of things such as if 
‘there are any new enemy units within range, or if your current target left focus. You can create 
our own Services. In this recipe, we'l assemble a Service that wil check If the opponent you 
are following is stl the closest within a silty cone. If nat, then the opponent changes 











‘There are four main events fora Service node (other than Tick): 


1. Recehe Activation Al: Tigers when the Behavior Tree starts and the nade is rst 
activated, 


2. Recelve Search Start Al: Tigers when the Behavior Tree enters the underlying 
branch, 


3. Recehe Tick Al: Triggers each frame where the Service is invoked. The bulk of the 
work is performed here. 


4. Recehe Deactivation Al: Tiggers when the Behavior Tree closes and the node is 
activated 


1. Fist add a New Service to your Behavior Tree via the New Service button in the 
Behavior Tree Menu Bar. 
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2. Name your Service something that describes what t does, such as Beha vi or Tr ee, 
Service, CheckTarget Stil Closest 
3. Doubleclick on your Service to begin eating its Blueprint. 


4. Inthe editor, add a Receive Tick A node, and perform any updates to the Blackboard 
that you need 


Service nodes execute some Blueprint code at some regular spaced time ntonals 
(with the option of deviation), Inside a Service node, you will usually update your Blackboard. 





Composite nodes frm tree nodes inside the Behavior Tree, and contain more than one thing 
ta execute within them. There are three pes of Composite nodes: 


‘Selectors: Go through children from left to right looking for a successful node. Ifa 
node fais, it vies the next one. When successful, tne node is completed and we can 
(9 back up the tree. 


Sequence: Execute from left to right, until a node fails. If the node is successful, do 
tenet one. Ifthe node fails, go back up the tree. 


= Simple Parallel: Single task (purple) in parallel with some subtree (ra. 


Getting ready 


Using composite nodes is fairly straightforward. You only need a Behavior Tree to get started 
with them. 


How to do it... 


1. Right-click anywhere on the blank space in your Behavior Tre diagram. 
2. Select Composites | Selector ar Composites | Sequence. 
E Selectors: Wil execute ali tasks in series until one succeeds 
© Sequence: Wil execute all tasks in series until one falls 


3. Append to the node a chain of Tasks or ther Composite nodes, as desired. 
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Attack 





f 


We can use a Behavior Tree to construct an NPC with mele attack behavior. The Melee 
Attacker mii have the following behavior 


1. Search for the best opponent tn attack every 10 seconds. The best opponent to 
attack is going à be the closest opponent within a Sear chad us, We wil achieve 
this using a Service. Chalk the opponent we are attacking into the Melee Attackers 
Behavior Tree Blackboard. 

2, Move towards the opponent we are attacking (indicated bythe Blackboard 


3, Mwe are within Att ackRadi us unts of the opponent, damage the opponent we are 
attacking everyAt tack Con! down seconds 








isis just one vay to tack an opponent using Behav ar Tree 

AEy oisi prd you can ien atch nae an aac aration ere 
Mp lee tacks case vu cous just oct 1a Py jan 
non within set Radius fine opponent 


Getting ready 


Havea Blueprint af a Melee Attacker Character ready I called mine P. Nel ex. Prepare the 
85. Nel ee Characters AI Controller tn use a nem Behavior Tree that wë wil create no 


How to do it... 


1. From the root we want a node that retums immediately if it falls. Create a new 
Sequence node witha Serdcecalledaeha vi ar Tree, Ser vice_Finddppenent 
inside f. Put the interval at 10 seconds for the node, 


2. Build outthesensvi orTree, Servi ce, FI ndOpponent node as flows: 
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3. Inside another Behavior Tree nade, indicate a per-trame motion towards the 
follow target: 


| 


Ed 





4. Finally wet lie to damage the opponent when in At tact Radius of him. When 
the player is within Att actRadi us „you can begin playing the attack animation 
(which could kick off damage event o the opponent) run a Damage Service every 
MitackCael gown seconds}, or simply Cooldown and Damage Opponent as shown 
inthe folowing screenshot 
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Custom Materials 
and Shaders 


Material defrition and creation tos in UEA are fantastic, otto mention its realtime 
rendering performance. When you sce our st gittering goid shader, you wl be amazed at 
UIS Material shading capabiities, which are possible with a bit of math. We wil show you 
hon to use these tools through the following recipes: 

1 Modifjng clar using a basic Material 

= Modifying position using a Material 

Shader code via Custom node. 

The Material function 

= Shader parameters and Material instances 

^ Gimmer 

Leaves and Wind 

= Rejectanco dependent on the veving angle 

Randomness - Perin noise 

Shading a Landscape 


In computer graphics, a shader is used ta color something, Traditionally, shaders were so 
called since they dened the shade that an object oo based on its original color and ight 
source poston, 





Custom Materials and Shaders 


Nowadays, shaders arent realy thought of as proving shading to an object as much as a 
testured al coor. 

















Z Shaders are about determinino the a erior ofan tjert nthe ight 
M, ree omer ptam, enna lowing tres aa 
‘ore pensie materal proper) 


“There are tuo javors of shader: vertex shaders and pel shaders. 


Vertex shaders: Colar at the vertex point inthe mesh), and smoothly shade from one 
Space point to another 3 space paint 


1 Pixel shaders: Color at the pel (point on the screen). The 3-space physical location 
ofa pixel (aka fragment) is calculated using some simple math. 


In UES, we just calla shader a Material, Materials abstract the verter and fragment 
processing pipelines into block programmable functions, so you don't have to think about the 
GPU or code to get the graphical output you desire. You simply think in terms of locks and 
pictures. You can construct Materials and build GPU shading functionality without ever writing 
a line of High Level Shading Language (HLSLI OpenGL Shading Language (GLSLI or Cp 

VE for graphies} cade! 


You wili commonly hear ofthe major GPU programming languages: HLSL, 
GISL and Cg, GLSL is OpenGL- GPU programming language, We HLSL is 
Microsofts offering After batting it out for popularity through the 905 and 
thers decade ofthe test certury Cg wes bamim an atempt is 
luna GPU programming under it Cg is stil papular, but GLSL and HESL 
iso remain in popular use. 


-guj 











The primary usage of Materials s o make surfaces appear in the cor you want them. In your 
scene, you ll have light sources and surfaces, Surfaces are coatedin materials that reject 
and refract the igh, which you then see using he camera's eye, The basie thing to do with a 
material is to modify the color afa surface. 


3) Beretinar the importance ot tuning our ight sources to make 
J) materia took as you wish them to laok! 





Getting used to the Material Editor takes some practice, but once you get used to it, you can 
o amazing things with it- In this recipe, me'l just use some of the very basic functionality to 
construct a wooden textured material. 


“esr versus Material: Keep în mind that there îs a big diference 
beween the terme tice and material. Ateture i just an erage HE 
a Cuch asa photograph of some wast. png |a materal, on the other 
Fana, a combination of ttre, colors, and mathematica formulae for 
deserting howa surface appears under ight Materiale will account Tor 
Surface properties, such as cor absorption, ejetanca and hniess, 
Wh a toture is Justa group of colored poe (er temele, as he GPU cal 
them, 





‘Shaders are programmed ust ike normal C+ code, only far more restricted. There are 
‘several parameter types you can choose from Most of them wil be ats or packages of 
eats arranged ina vector format (sat f [ast 1,! at 3, est 1) For Dings suchas 
Bostione and colors, you'luse?| oat of aat; for things such ae texture coordinates, 
you uset ast 2 


Getting ready 


‘You need a clean UEA project into which you want t place your new material. Install the 
‘GameTexture Materials pack from the UEA Marketplace (Epic Games Launcher Application) 
in your UEA project. contains some required textures that well need for this recipe. You also 
need a piece of simple geometry to show the results of your shader 
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How to do it. 


1, To create a basi material rightclick inthe Content Browser, and create a Material 
{avaliable from the top four Basic Asset elements). 





2. Name your material for sample, Go! den Nater i a! | then double-click on it to 
ett 


3. Welcome to the Material Editor: 
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‘You cn el itis the Material Editor because of the presence of the Material output 
node on the right. To the left is a 3D rendered sphere demonstrating what your 
material looks Ike. Materials start out as a kind of colish black sem-shiny material 
We can adjust all the materiai parameters, believe it or not, to make anything fram 

a material that emits ight ike the Sun, to water, or to the texture of a units amor, 
Let us begin by adjusting the output corso the material to create a gold<olored 
metalic materal, 


1 


Change the Base Color to yellow by right ccking on any bank spot in 
"he Material Editor window and choosing a Constant3Vector (which 
‘represents an RGB color. Jt the color by double-clicking an the node 
and dragging around the value of the color swatches. Connect the output of 
‘the Constant3Vector to Base Color, and walt or the ID picture on the left 
"o reload with yout new materals appearance. Connect the output o th 
Constant Vector to the Base Color to give the material a yellow appearance 
as shawn in the following screenshot: 


Selecta metalicnese level for all channel by attaching a constant value. 
"o Ihe Metallic Input, and setting to 1. 1 is very metalic, and is not 
metalic at al and so will look pasti ike the materal shown in the next 
screenshot. 








m 
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3. Choose a Specular value fer the material, again between 0 and 1. Specular 
materials are shiny, hile non pecular ones are not 


4. Choose a Roughness value for the material. Roughness refers to how 
spread out the specular highight ie f Roughness is high near L0), then 
Me surface ilie, wth almost specular highlight The specular highlight 
appears fat and wide near the values 0.7 or 0.8. When roughness ls near O, 
"hen the specular highlight is very sharp and thin estremelyshiny/ mirordike 
surface) 


p, The materialon the let has roughness =0, and the materialon the ig 
SS has mugress = 


5. Apply your material to an object in your scene byclicking and dragging the material 
fonts the model mesh that you want the material to apply t. Atermatehy select a 
model mesh component, and the nen material that you have created by name in the 
Detals pane, 

65, Finally create a ight in the scene to examine your materials response properties 


further Without a ight. every material appears black (unless its an emissve 
material) Add a light via Modes | Lights. 
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Modifying position using a Material 


Ales common thing to do is tn use a Material to modify an object positon. This is 
Commonly done n things such as water shaders. We do I using the Warid Position Offset 


ode inside the Matera output 





We can modulate the output poston of a vertex using some GPU math, This tens the load 
of rendering realistic water on the CPU bya sigribeant amount. 


Getting ready 


‘Create a piece of geometry in your world. Construct a new shader called Sob, which we'l edit 
"o produce a simple bobbing mation fr objects rendered with te material 


How to do it... 


1. In your new Material [named 5o) rightclick and add Texcoord and Time 
Input nodes. 

2, Cascade the sum of the Texcoord (for spatial) and Time Input nodes through a 
Si) function cali to create some wavy displacement Multiply the output of the 
Sil] function, and pass as Zinputs to World Displacement. 
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[sx Part of the simple water shader given in the code of Chapt er 11 ] 


‘hat produces the deplacement. 


3. Select PN Tangles under Tessllation | D3D1TTessellaton Mode, and set 
Tesseltion Multiplier in the materal to 1.0. 


Moral spent and ansherccmotbecnbie in EA 
‘hater Gove: sae Per greta ie aue] 
Vy ating tode goes atow youi erate ns rata see 
So mda pau aon raara M atai n prent. aed Da 
P Fataar Lane ng T wina Slat col windon 





m node 





1 you preter code to diagrammatic blocks, eue in luck. You can write your wm HLSL code to 
‘ploy tothe GPU far the shading of some vertices in your project: We can construct Custam 
modes that simply contain math code working on named variables to perform some generic 
Computation. In this recipe, wel write a custom math function to work wih 


Getting ready 


‘You need a material shader, and a general mathematical function to implement. As an. 
‘example, we'l wll Custom node that retums the square ol all inputs. 
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How to do it. 


1. in order to create a custom material expression, simply right-click anywhere on the 
canvas, and selec! Custom. 





2. With your new Custom block selected, go to the Details panel on the left side of 
your Material Editor window (choose Window | Details f your Detalls panel is not 
spied) 

3. Under Description, name your Custom block. For example, Squar e3, because we 
planı to square re joat inputs and retum af | ast 

4. Cik the +icon as many mes you need to generate as many inputs as you need to 
serve In this case, were going to serve three fat inputs, 

5. Name each input. Weve named ours x y and z in the diagram that follows. To use 
each input in the calculation, you must name i. 

S. Select the output ype. Here we chose to outputa fI oat 3. 


T. Enter the computation in te Code section at the top using the named variables you 
have created. The code we return here is as flows 





reture rti xta, yy) 
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ratthis dass construct a oot vector, and retum the square of Xin 
the valve, the square of Y in the y value, and the square of Zin the z 


value 

To retum diferent values for X Y, Z components ofa vector type, we had 
toretumacalitoaf 1 at 3 ort o2t4 constuctor I youve nat returing 
a vector pe, ou can just usea r et ur n statement (whut calinga 
‘eat constructor 


A custom node is really usta bit of HLSL code. Any valid HLSL code can be used in the code 
tes peld. Avertoxor pel shader program has several standard inputs int These standard 
inputs have been defned for a very long time, and they are the parameters you can use ta 
change the way your geometry renders. 

















HLSL and Cg have a concept called semantics, which attaches a kind of concrete typing to a 
oat. This is done so that the extemal program calling the shader knows where to put which 
input when caling your vertex or pel shading program. 


Inthe folloning Cg function signature, in addition to being a f 1 oat variable, i nřasi ti aa 
is semantically P051 T1 Ck typed variable i nTa conr a TEXCOORD typed variable, and 
intel a à COLOR typed variable. Inside the shader, you can use the variables for anything 
ou want, the semanties are simply for routing the correct input to the correct variable lto 
make sure that the color comes i on the COLOR typed variable—othermise, we'd have to do 
‘serrething ike track the orderin wich the parameters are speciped or somthing) 


The output parameters of the function specty how the output of the shader is to be 
interpreted. Interpretation is only for the recipient of the output data of your program (the next 
stp in the rendering pipeline]. Inside your shader program you know you are just writing out 

a bunch of jets to the shader pipeline, There's noting that forbids you from rising erent 
yes of semantics inside the shader A COL OR semantic variable can be mulled bya 
POSITI Ou semantic input, and sent out as a TEX COORD semantic output I you so desired. 





a 
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The M 





terial function 


Je always, modularity is one of the best practices in programming. Material shaders are 

no exception: itis far better if our shader blocks are modular, and can be boxed out and 
dert as named functions. This way not nly are your shader Blocks dearer, but they can 
atso be reused in multiple Material shaders, or even exported to your local UEA brary for 
future use in other projects. 


Getting ready 


A reusable or repeatable black of shader functionally can be factored out af your custom 
material shader program In this example, e'l write a simple function serles-#qua re, 
Square2,Square3, and Squa r et that squares input values. Get ready to perform the work 
inthis recipe by opening a UEA project and navigating to the Content Browser, 


How to do it... 


1. ightelck inthe Content Browser, and select Materials & Textures | Material 
Function. 


Cube Render Target 





2. Name your Materlal Function Sauar e. 


3. Doubleclick on Mat 





al Function. 
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4, Ae soon as you open Material Function, deselect the Output Result node byl 
Clicking anywhere in the blank canvas space of the Material Editor. Take a ook at the 
Detals panel, and note that the Functions exposure to the UES library is optionally 
avaiable 





5. The Expose to Library checkbox appears in the Details pane! when no nodes are 
selected in the Material Function Editor sereen. 


S. Rihtclck anywhere in the blank space in the Material Function editor, and select 
Input. Name your input Notice how Input nodes are only available în the Material 
Functions editor, notin the normal Materia editing vew. 


T, From any regula Material, inke your function by doing one of the following: 
1. ‘Right-click in the lank space, and select Mat er ia! Funct on, then select 
our Natar lal Funct en fróm the dropdown menu- 
2. ‘Right-click and type the name af your Material Function (this requires you to 
have expased your Material Function previously, 
8. yeu dont mant to expose your Material Function to the UEA libra, then you have 
tose alist eri al Funct on black to call your custom function, 
9. Rightclck anywhere in the Material Function editor, and select Output 


Matera Functions are some of the most useful blocks you can create. With them, you can 
madularize your shader code to be much mare neat, compact, and reusable. 


There's more. 


Migrating your functional to the shader Ibrary is a good idea. You can make your custom 
function appear in the function ibrary by choosing Expose to Library in the root of the shader 
(provided you have nothing selected in the Materal Editor window) 


When developing a Material Function, sometimes, is helpful to change the Material Preview 
mode taa node der than he output nade. Preview a specie node's output byrighe-cieking 
‘he output jack far any node and selecting Start Previewing Node. 


-gnj 








The window in the top-left comer of the Material Ecitar wil now show the output af he. 
mode you are previewing. In addon, the text Previewing wil be added ta the node you are 

previewing fis net the bai output node), Ensure that Live Preview is enable in the menu 
barat the tap af the Material Editor: Typically you woud want the Pal output to be prevene 





Shader param 





A parameter to a shader is going tobe a variable input to that shader, You can congue 
scars or vectors to be used as Input parameters to your shader, Some materiale within UEA 
‘ome preprogrammed with materal parameters exposed. 


Getting ready 


In order to set up a parameter to a shader, you frst need a shader with something that you 
wantto modify with a arabe. A goed thing to modify with a variable s the suit color fa. 
character, We can epose the color of the sult as a shader parameter that we multiply sult 
olor by, 


How to do it... 


1. Construct a new Material. 





2. Within the Material, create a Vect or Parameter Give the parameter a name, 
suchas Color Give ta delaut value, such as blue or black. 
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3. Cose the Material 


4, in Content Browser, right-click on the Material with the parameter in t, and select 
Create Material Instance. 
5. Doublecick on your Material instance. Check the box beside your 
ector Parameter name and wila! Your Vector Par anet er is customizable 
without further affecting the base funcional of the Material. 





8. Further, if you change the base functionality of the Material, the Material instance wil 
Inherit haze changes without needing ary further canbgtion, 


Material Parameters allow you to edit the value of variables sent to a Material without edting 
"he Material self In addition, you can also change a Material instances values from C++ 
code quite easily. This is useful far things such as team colors, and the ike. 


‘Some shader functionalty is easily accessibie using the standard nodes inside the UE 
Material Editor. You can come up with some neat speckled effects, such as the altering gold 
shader we show you how to construct in the following recipe. The purpose of this recipe i to 
familiarize you with the Material Editors base functions so that you can learn to construct our 
‘oun material shaders 


Getting ready 


Create an asset (such as a treasure chest) that you want to glow, or open the the source code 
package of Chapter 11 toþndthetr easureChest. f bz model. 





What weti do is move a plane across the object of a certain thickness W. When the plane 
passes over the geometry, the emissive color channel is activated, anda glimmer eflect ie 
Created across the treasure 


= 
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We expose several parameters to control the gimmer, including Speed, Period time between 
dimmers| Width, Gain, PlaneDirecion, and þrally Color, 


How to do it. 


1. Create new Material byright-cicking in the Content Browser, and selecting 
Material 


2, Add input parameters to scale time as shown in the folowing image, pulling in a Ti ne 
input, and making it periodic by calling F mod with the period of time: 





Frrttne) 














3. Fmd with period wil make time folewa sawtooth pattern. The value of time read 
vill not increase past the Period, because we wll keep Kicking it down to D using the 
‘nod operation: 

4. Provide the On! ane function ina separate He Then?! ane function uses the 
Plane Equation Ak-&By & Cz +D =0 to determine ifan input point is on a plane or 
not Pass the Local Pasi ti an coordinates nto the 0171 ane function to determine 
i the given frame, this section should be highlighted with emissive glow in the 
geometry ar not 


Hov 


An irragnary piane af ht passes through the geometry at the speed speciped by speed, 
once every Period seconds. The plane starts at the comer of a bounding box in the direction 
‘speclbedbyPlaneDirection, The plane always starts at the corner of the box where twill pass 
‘rough the ene volume when the plane is shifted forward wth time. 


t works. 
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and Win 


inthis recipe, well rte a simple particle shader demonstrating how to create leaves in wind. 
We can doso usinga Particle Emitter combined with a Material Shader that Shades" our 
leaves to give them the appearance of blaming in the wind. 


Getting ready 


To begin, youll need a leaf texture aswell as a scene in which to place the fang leaves. In 
the Chaster 11 code package, youll prda scenecalled Leaves AndTr ee that contains a 
deciduous ree that you can use. 


How to do it... 


1. Create a nen particle emitter by right-clicking in the Content Browser, and choosing 
Particle System. 


2, Construct a new Material shader by rightclicking în the Content Browser and 
choosing Maternal. Your leaf material shouid contain a tur of a leaf inthe 
EaseCol ar component Wel edit the World Position of the leaf in a later step to 
represent a jiter in motion represented bythe wind 


3. Add a couple of parameters to modify the Leaves particle emiter 
1. Spawn should have a nice high rate of about 100. 
2. Initial Location can be distribute in a cube of 100 units per sie 
3. Lifetime can be 45 seconde. 
4 


Initial Velocity shouldbe something ke ranging fom (50,50,100] to 
52540. 








+ 
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5. nial Color can be a distribution vector with values at green, yellow, and 
E 





6. Acceleration can be (0,20). 
7. Inia Rotation Rate can be 0.25 (ma 
3. An Orbit parameter can be added with distribution (0,0,0) e 01012). 
4. Wind: Create a Material Parameter Collection (MPC) by right cickng anywhere 


in the blank space in Content Browser and selecting New Material Parameter 
Collection. 





5. Doublecick to edt your new Material Parameter Collection, and enter a new 
parameter The i nd. Give inal values of (1, 1 1) 

5, In your level Blueprint (Blueprints | Level Blueprint}. create a clientside variable 
called The nd We wil send this variable doum to the GPU in each frame after we 
change k locallyat the CPU. Initialize the Theni na variable to| 1, 1, 1) in event 
Begi nP ay 

7. In the Event Ti ek, madly the wind to your Iking. In my version of the wind, Ihave 
multiplied the wind in each frame bya random vector with values between [-12]in 
three dimensions. This gives the wind a nice jittery ook perrame, 

3. Send te wind variable update own to the GPU by choosing a Set Vector Parameter 
Value node immediately after you modify the wind vector. Te Set Vector Parameter 
Value must reference a variable inside a Material Parameter Collection, sa reference 
Thaw nd variable inside the Material Parameter Collection that we created in STEP 4. 


9. Modify Wr Pas ti ost! set bysome multiple of TheWi nd each frame. Since 
Then variable varies son the madipaton preserted in each frame wil bea. 
‘ight variation of the medication presented in the last frame, producinga smooth 
Teal mation 





The leaves fal at more or less a constant rate with additional ight gravity, but they are pulled 
around bya constant} varying wind vector inside the shader. 
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Custom Materials and Shaders 





The tendency af the rejectance of a material to depend on the viewing ande is called 
the Fresnel effect A material may be more specular from a grazing ange tha fom a 
head-on ange, 





Seen inthe preceding screenshot has igh specularbyand opaety ata 


The Fresne fict has magnitude at a grazing angle. This water material 
grazing ande de to use of te Fresnel eflect 





[ 


VEA has a specallybultin capability to account for this, Well construct a water shader that 
has vew-angle dependence far translucency ta give an example af how lo use the Fresnel 
affect realistically 


Getting ready 


‘You need a new shader to which you want to add the Fresnel effect. Preferably selecta 
material that you want t look a Bit diferent depending on the viewing angle 


How to do it... 


1. Inside your material, drive a channe! (ether Opacity, Speculartty, or a diffuse color) by 
the output of a Fresnel node. 
2. The Fresnel node's parameters Exponent and Base Reject Fraction can be adjusted 
a2 follows 
1. Exponent Deseribes how Fresnel the materia is. Migher values here 
exaggerate the Fresnel effect. 


2. Base Reflect Fraction: Lower numbers exaggerate the Fresnel Effect. 
For a value of 1.0, he Fresnel effect wil not manifest. 





-gnj 





‘Theresa fair bit of math behind implementing the Fresnel effect, but using to dive a. 
component in a material is aly easy. and can help you come up with some very aut 
foking materials 


ndomness rlin noise 


Some shaders bene fromthe abilityto use random values, Each Material has a few nodes 
iat can help add randomness ta a shader Randomness rom a Perlin noise tndure can be 
used to generate interesting looking materials such as marbled materials. The noise can also 
Þe usedi to drive burp maps, height maps, and displacement ol for some neat effects. 


Getting ready 


‘Choose a material to which you'd ike to add some randomness. Open the Material in the 
Material Editor, and follow the steps, 


How to do it... 


1. Insert Noise node into your Material Editor window. 


2. Normalize the coordinates af the object youre adding the noise to. You can use math 
suchas the following to do so: 





1. Subtract the minimum from each processed vertex in the system to take the 
object tostat the origin. 


2. Dhide the vertex bythe size of the object to put the abject I a unit box 
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Custom Materials and Shaders 


3. Multiply the vertex value by? o expand the uit box from 2x to 212. 


4. Subtract 1 from the vertex values to move the unit to being centered nthe 
origin with values from (4-1-4) to (42.42.42 


3. Select a value fram which to draw noise. Keep in mind that noise works extremely 
well with input values between SX <+]. Outside of his range, Pris noise 
‘starts to appear snowy when zoomed out (because there wil be too much variation in 
the output values over your input x} 


Perlns noise can help you produce some beautiful marly textures and pattems. Besides 
using itin graphics, you ean also use Perin noise to ve motion and other phenomena in a 
aural loking way. 


Shading a Land: 





Landscape shaders are relatively easy to construct. They allow you to specify multitexturing 
fora very large custom piece af geometry called a Landscape. 


Getting ready 


Landscape objects are fantastic for use as a ground plane for your game word level. You 
can construct multiple landscapes in te same level using the Landscape tab. Access the 
Landscape palette in the Modes panel by clicking on the picture ofa mountain, as shown in 
the folowing screenshot: 


ta E Ņ 
A d 


ww 


4 Landscape Editor 
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How to do it. 


1. Construct a new Landscape object by clicking on Modes | Landscape. Under the 
New Landscape heading, select the Create New rado button. You will see a green 
wireframe oveiay proposing the new landscape, You can adjust ts se using the 
Section Size and Sections Per Component settings 


‘Yau can keep nate of this number if yeu want ta make the landscape. 
tertur ie feer times -simply dide the UV coordinates fed to the 
testures bythe number computed in the preceding ine. 


The landscape wil tle the tentures we select forit Section Size * Sections 
Per Component * Number of Components tes when we fay etre. 
2 


Do nat click on anything else in this dialog yet, as we stil have to construct our 
Landscape Material This is outlined in the folowing steps. 
3. Navigate to Content Browser and create a new Material for use by your landscape. 
CalkLandscapeNateri al 
4. EdtyourLandscapeNaterial by doublecicking on it Right ik anywhere in the 
blank space and selecta andecspeCoer di nat e node to feed the W coordinates 
through the textures that we're about to apply. 
E To reduce the tiling on the Landscape, ou need to divide the output of the 
LandscapeCeardi nate node by the tatal size of the landscape (Section 
Size * Sections Per Component * Number of Components} (as described in 
aipin sep 1) 


5. Adda Landscapelayer8! en node to the canvas. Lead the output of the node to 
the Base Color layer. 

5, Cik on the LanéscapeLayertl en node, and add a few Layers to the element 
in the Details tab. Tris will alow you to blend between the textures using Texture 
Painting. ame each, and select the method for blending fram among the folowing 
options: 

E By painted weight (LB Weight Blend. 
© Byalpha value inside the tour (L8 Aha Blend 


t By height (LE Height Blend) 





7. Setother parameters foreach LandscapeLayer youre adding as you desire, 
3. Feed in the textures, one for each layer of Landscape blend. 


9. Reduce the specuarlyof the landscape to 0 byadding a constant O input to the. 
Specular input 


10. Save and clase your materia. 
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‘custom Materials and Shaders 
11. Goto the Modes | Landscape tab now, and select our newly created 
Landscanelater iat inthe dropdown menu. 


32. Under the Layers section, click on the con beside each of the Landscape layers 
that are available. Create and save a Target Layer object for each Landscape layer 
that you have 


23. Finally, scroll down the Landscape tab, and click on the Create button. 


14. Click on the Paint tab, select a brush size and a texture to paint with, and begin 
texture painting your landscape. 


Landscape materiais can be blended either byheight, or by manual artistry, as shown 
inthis recipe. 
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Working with UE4 APIs 


The Application Programming Interface (API) isthe wayin which you, as the programmer, 
instruct the engine, and so the PC, what to do. A of UEA's functionality is encapsulated into 
modules, including very basic and core functionality: Each module has an API for it To use an 
API, there is a very important linkage step, where you must list all 4s that you wil be using 
in yourbuld in a Pr oj ezt Name. Bui 1 d. cs He, which is located in your Solution Explorer 
windon. 


Do not name any ot yaur UEA projects the exact same 
name as one af te Ut API names! 


A b-S em opl] 
T in (n 5 
E solution Cute? pj 


n 


contig 
Capt? 


> ter Dependence 
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Weng ith UER As ——oo 
There are a variety of Pl inside the UEA engine that expose functionality to various essential 
parts af it. Some of the interesting As that we'l explore In this chapter are as follows: 

= Core Logging API ð Depning a custom log category 

Corel Logging API F Mess ageL ag to write messages to the Message Log 

‘Core Math API - Rotation using Rat ator 

Core Math API- Rotation using Quat 

= Core Math API- Rotation using Ft at an Nat ri x to have one object face another 

= Landscape API Landscape generation with Perlin noise 

= Folage API Adding trees procedural o your level 














= Landscape and Foliage APIs - Map generation using Landscape and Foliage APIS 
= Gameplayiilties API - Tiggering an actor's gameplay abilties with game contrat 
= Gameplayibilties API Implementing stats with At t r i but ese: 

= Gameplayabilties API Implementing buts wih Gase 
= GameplayTags API- Attaching Gamep! ayTags to an actor 

= GameplayTasks API Making things happen with Gameplay Tasks 
m HTTP API- Web request 

HTTP API- Progress bars 








antec 


Introduct 





n 


The UES engine's base functionality available in the editar is quite bread. The functonalty 
trom C++ cade actualy grouped Out into Hte sections called APIs. nere a separate 
API module for each important functionalityin the UES codebase. Tis s done to keep the 
codebase highly organized and modular. 


ifi are gating buid errs, be sure ta check that the nage wi th 
Vb corect Apis is tere! 





di, _ sig diferent Pt may regire special nage in your Bni 4. cs Ha 
N 


The complete API isting is located in the following documentation: nt tps: || dors 
unrealengi ne. com] atest) NAP I 
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UES itself defnes several logging categories, including categories such as Lag4c tor hich 
has anylog messages todo with the het ar class, and Login: mati on, which logs messages 
about Arimetons in general; LEA debnes a separate logging category for each module. This 
Allows developers to output their log messages to different logging seams. Each log steams 
narre is prebed to the outputted message as shonn in the loving ample log messages 
from the engine: 


Lestertertüreeser: ative class Blerarchy updated fo 
Hierarchical LODOutl iner" 1a MOBIL seconds. Added I classes and 2 
LogLead: Full Startap: 8.88 seconds (BP compile: 0.07 seconds 
Logstreami ng: Warning: Failed to read file 

Te i Heigl nel Content) ditor] Slate) Connon) electi er, Lev. peg 
legirternal Proti ler: Found exteraal profiler: VSPert 





“The above are sarpielog messages fromthe engine, each pred with their log category 
Warning messages appear in yellow and have Warning added to the front as well 


The wample code you vill ind onthe Interet tends to use ogTenp for a UEA projects own 
messages, as flows: 


ME LOG, LegTerp, Warning, TEXTE “Message 4" 





We can actualy improve upon this formula bydetring our onn custom ogCat eger y 


Getting ready 


Have a UEA project readin which youd Ike to depne a customilog. Open a header He that 
Wil be included in almost all Bes using this log. 


How to do it. 


1. Open the main header He for your project for sample, if your projects name 
is Pong, youll open Peng. h. Add the following Ine of Code after #i nc! ude 
Engine. 


DECLARE LOG.CATEGORY EXTERN] LogPong, Log, AII Ni 1/ Pang: 





T 


ring with UEA APIs 
Debredinhsserti anNacr os. h, there are three arguments to this declaration, 
ich are as fllons 
© Category aee: This is the log category name being defined (LogPong 
here) 
Default Verdes! ty: This is the default verbosityto use on log messages 
© Compi Iei mever bosi ty The i the verbosity to bake into compiled code 
2. Inside the main. <p He or your project, include the following line of code 
FINE LOG CATEGORY| LogPong ): [| Pong. cpr 
3. Use your log with the various display categories, as follows: 


Ut LOGI LogPang, Display, TENTI *A display message, lug is 
waiting 1): IT shows 1n gray 

UE LoG| Loghoeg, Warning, TEXTU "A warsing message" ) | 
UELOG| Laghosg, Error, TENTI “An error message * |} 


Logging works by outputting messages to the Output Log Window | Developer Tons | 
Output Log) as well asa He. Al information outputted to the Output Log s also mirrored to a 
simpe tæ He thats located in your project's Saveti) Logs folder The extension of the og 
Hesis. og, mith the most recent one being named Your Pr oj ect Name. ag. 


There's more... 


You can enable or suppress eg messages for a particular lag channe! fom within the editor 
using the following console commands: 


Log Legere oft Ji Stop Loglame from displaying at the output 
Log LagMeme Log / Turn Legiones output on agal s 





Y you eto edit the intial values of the output levels of some of the builtin log types, you 
‘can use a C++ class to create changes to the Engi ne. ini cob ie You can change the 
intial values nthe ensi re.i ni corbgratien e Seehtt ps: lw ki unreal engi ne 
Komi Logs. Printing Messages Ta. Yeursel f Duri ng, Aunti me for more detalls 








Chapter 12 


See also 


* UL 





6 sends Its output to Output Window. I you'd Ike to use the more specialized 


Méssage Log window in addition, you can altematielyuse theF essageLog object 
to write your output messages. F Nes sagel og writes to both the Message Log and 
the Output Window. See the nest recipe for detalis. 





FHessageL og isan object that allows you to write output messages to the Message Log 


(Window | Developer Tools| Message Lag) and Output Log (Window | Developer Tools | 
Output Log) simultaneously 


Getting ready 


Have your project ready and some information to og to Message Log. Display Message Log 
in yaur EA Editor The follwing screenshot is of the Message Log 


1. Add deti ne to your main header fe Pr oj ect Na me. h) debringLOCTEXT, 
NAMESPACE as something unique to your codebase: 


tief lee LOCTEXT_MAMESFACE "Chapter 2Namespare" 





This sde i ne Is used bytheLOCTEXT(] macro, which we use to generate FText 
objets, but is not seen in output messages. 


2. Declare your ess aget og by constructing it somewhere very global. You can use 
extern inyour?r ect Nase. h He. Consider the folowing piece of code as an 
example: 
extera Flame Loggerhane 
stern FNessagelog Logger 
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Mixing with UEA APIs 


3 And then, create ourFilessageLoy bydeiringitina. cpa He and registeringit 
vith Wess ageLogNedal e. Be sure to give your logger a clear and unique name 
n constuction.’ the category of your log hat wil appear to the left of your log 
messages in Output Log. For example, Proj ect Name. car 
getline FIEAT( a) LOCTEXTG, 1) 

Pare Laggertiane( “Chapter 2.09" ) 
FueseageLag CreateLog| Flare nane | 
t 
FnessageLogliodul ek Messagelagliodel e 
Pisis eenager:-Laadhadsl eCheckacefecsageLghodel e> 
Irlessagetag") 
HlessageLogi nti zatlontpt ions Ini t Opti ons: 
Inl Options. bshowPages = trusii] Dort forget this 
irl tüpt ions. béhan ters = true 
Ht LapListiaghane = HENTI “Chapter L2*s Log Listing 
1 
WMessageLegNadul e Regi sterLogilsting( Logger tame 
Logisti ngame, ini 0pti ons} 
] 
|) Someehere eariy in your program startup 
|) (ey in your Camehose constracter| 
Achapter2Gameviage: AChapt er12Gemeuod| | 
[ 
Creatatagger| Lopperkame | 
Ji Retrieve the Log by using the Loggertane 
FMastagelog logger( Logger tame ) 
logger. Marni ngt 
TEXTE “A warni ag message from ganemde ctor* |] 





i 


The KEY toLOCTEXT (estargament) must be unique or you wll get 

predoush hashed string back. 1 you'd Ike, ou can incude a Fée i ne 

hat repeats the argument to LOCTENT twice, as we d eae. 
sisi ee FTEAT(a) GOCTERTUX, x 





4, Log your messages using the following code: 


Logger. nfof FTEATI "Info to logt 1) 
Lagger. Warning] FTEXT| "Warning tent to la 
Lagger.Errort FTEXTI “Errar text ta Lag) | 
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‘This cde utlizes theF TE ITI | macro dened eater. Be sure itis in your codebase 


Constructing yaur message log again aftar intiatzation retrieves a copy of 
the original message eg For example at ary place nthe code, you can 


message 


PI - Rotation u. 





Rotation in UEA has such complete Implementation that t can be hard to choose 
hon ta rotate your objects. There are three main methods- Rotator Fat and 

FRotat oat 1, The recipe outlines the constuction and use of the prst of the three 
different methods for the ratation of objacts—the F Rot str. Using this, and the flloning two 
recipes, you can select at a glance a method to use to rotate your objects. 


Getting ready 


Have a UES project that has an object you can get a C+ interface with. For sample, you can 
constructa C++ clase Coin that derives from Act or to test out rotations with. Override the 

ni n21 Ti ck] method to apply your rotations from the C+ cade. Atematively, you can call 
these rotation functions in the Ti £k event from Blueprints. 








In this example, we will rotate an object at a rate of one degree per second. The actual 
rotation will be the accumulated time since the abject was created. To get this value, wel just 
fall igre | aTi meSezonds 


How to do it. 


1, Create a custom CH derivative ofthe Act or clase caled Coi n 

2, Inthe C+ code, override the: Tick) function ofthe Coi n actor derivative. This 
wil aon you to effect a change to the actor in each frame. 

3. ConstuctyourF aot ater. FRotators can be constructed using a stock piteh, yaw, 
and roll constructor, as shown in the folowing example: 





4. Your Rot at or wll be constructed as follows: 
Fhotator rotatart 0, GetWorla{|-oTi neSecenss, à 





mu 


Mixing with UEA AP 


5. The standard orientation for an otjectin UE is with Forward facing down the +X ax 
Right ie the +Y ais, and Up is 4. 





6, Pitch is rotation about the Y ans (across yaw is rotation about the Z axs (up) and 
vols rotation about the X anis. This Best understood In the following three points: 


© Pitch ou think of an airplane in LEA standard coordinates, the Y axis 
oes along the wingspan (aching tits it forward and Backward) 


Yow: TheZ aés goes straight up and down (yawing tums left and right) 


E Rolt: The X as goes straight alang the fuselage of the plane (ling does 
barrel rol] 


R) Ye shouta note hat in other carvensons, ne xais is 
Ml pn e Yai i cand te Pacer 


7. AoplyyourFRotatar to youractor usingthe Set Act or Rotat ov member function, 
ac fotons: 





Flatstor rotator( 0, Getlrl{|-oTi neSecenss, d 
SetdetorRetati ont rotation | 





Math API - Rotation u: 





Quateions sound intimidating. but they are extremely easy to use. You may want to review 
‘he theoretical math behind them using the folowing videos- 


* Fantastic Quatemions byNumberphie - àt tps: || wwe. youtube. comf 
ath? r=DHRBER- Lug 
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* Understanding Quaterions by im Van Verth- ht ta: | gdevaul t- co 
play! 217853/ Mat h- for Game: Programmers- Understanding 





However, we wont cover the math background herel n fact, you dont need o understand 
‘much about the math background qualerions to use them extremely effectively. 


Getting ready 


Have a pojectready and an Act or wth an override: : Ti c| function that we can enter the 
Cht code ino, 


How to do it. 


1. To construct a quatemion, the best constructor to use is as follows: 
Fauat| FVector Axis, float Angl etat } 


Far ampie, to definea twisting rotation: 

Chatsmanshawe quatenion aon, uation bacon, 

MR, mutpkcatontysteabnaddvin bya scalar dfs ram 
rotate ncn Tyree etl sag at 
Sarr anges and pait obec Stone sae 





How it wo 


Quaterons are a bt strange, but using them is quite simple. I vis the a around which to 


rotate, and @ is the magnitude of the ange of rotation, then we get the following equations 
for the components of a quaternione 














a 





een with UER AP ooo 


So, for example, rotation about 
uatemion components 





Tree ofthe four components of the quatemion (x y, and 2) depne the axs around vich to 
rotate (scaled bythe sine of half the angle of rotation), while the fourth componant (w) has 
‘nly the cosine of half the angle to rotate with. 


Quitemions, being themselves vectors, can be rotated. Simply extract the bx, y, z) components 
fof the quatemion, normalize, and then rotate that vector Construct a new quaternion from 
"bat nem unit vector with the desired angle of rotation. 


Multiplying quaternians together represents a seres af rotations that happen subsequently. 
For example rotation of 45? about the X avis, followed bya rotation of €5¥about the Y ais will 
be composed by the flowing 





Fouat( Fvectort a, 8, 0 |, PIA 
Fouat( Plecter( 8, 1, 01, H4 


Core/Math API - Rotation using 
FRotationMatrix to have one object face 


another 





Flotatioslat ix offers matixconstuction using a series of: Make * routines. They are 
easy to use and useful to get one abject to face another. Say you have bwo objects, one of 
aich is following the other. We want the rotation of the follower to always be facing what it is 
folowing. The construction methods of Ret st i onat rs x make this easyto do. 
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Getting ready 


Have two actors in a scene, one of which should face the other. 


1. Inthefolloners Ti ck|) method, look into the available constructors under the 
FRotati oet ri x clase. Available are a bunch of constructors that wil let you. 
‘specify a rotation for an abject (from stack postion) by reorienting one or more of the 
X Zones, named with the Rot ati onMat ri x: Make” (| pattem, 

2. Resuming you have a default stock orientation for your actor (nith Forward facing 
down the +X anis, and up facing up the +Z ans), prei the vector frorn the follower to 
the object he following, as shown in this piece of code: 


vector tefal ow 
Getfctorbacat ant] 

Figtris ratationiatri = FAotati onbatri x: abere 
targets Get ActorUpvecteri| > 

Setictorketati ont retatiseltr s Rotator | 


‘Getting one object to look at another, ith a desired up vector, can be done by cling the 
correct function, depending on your abject stack orientation. Usually you want ta reorient 
the X ants (Forward), while specifying either the Y aés (Right) or Zan (Up vectors Fat ati o 
Mata: abet emt). Fr example, to make an actor look alonga | ookal ong vector, 
with ts right side facing right, we'd construct and set Flat at on Nat r i x faritas follows: 





Faovatiannatria rotatioaMatrix = FRotati enl ri c efron 
Teaekt ang, rignt} 
setar-pSetActarRetatlon| ratati oniütri x. Retater(] ): 





a 





Y you use ALandscape in your scene, you may want to program the heights on it using code 
instead of manual brushing tin. To access the Landscape object and Is functions inside 
of your code, you must comple and Ink in the Landscape andLandscepeési tor APIS 





Getting ready 


Generating a landscape is not terribly challenging. You need to lk in both the Lands cage 
andLandscapzEsi tor AP, and also have a programmatic way to set the height values 
"cross the map. In ths recipe, wel shaw how to use the Perin noise for this. 


Previously you may have seen Perlin noise used for coloration, but that is not al itis good 
for. kis excellent for terrain heights as well You can sum multiple Perin noise values to get 
beautiful fractal ose Itis worth bri study of Pertin noise to understand how tn get good 
outputs, 


How to do it... 


1. Retrieve the Perlin noise module tom ttp: || ebstal f.i tn. | ju. sel =stegul 
aasis asi s- newnoi sei etu Hes youll needarenoi 21234, h and 
ʻai $1234. cpo or you can select another pair of nolse generation Hes fom this 
‘repositoryif you wish) Link these Hes irto your project and be sureto ŝi nc! use 
YourPrecompi l edMeader.b inlonoi se1234. cpp 

2. Unkinthe Landscape and Landscapetdi tor APlsinyourPro] ert. uil d. cs 


He. 
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3. Construct an interface using UNG that allows you to click a Generate button to call 
a C++ function that wil ultimately populate the curent Landscape with Prin note 
‘les, You can do this as flions 


Right-click on your Content Browser and select User Interface | Widget 
Blueprint. 

Populate Widget Blueprint with a single button that kicks of a single Ge 
function. The Gen! } function can be attached to your Chapter Ga melde. 
derived cass object as that is easy to retrieve fom the engine. The Genf | 
function must be8i uepri nt Cal tabl e UFUNCTI On|). [See the Creating 
A UFUNCTION section in Chapter 2, Creating Classes, for details on howto 
doso) 








Be sure to display your UI by creating t and adding itto the vienport in one 
of your booting Blueprints: far example, n your HUD Begi n*l sy event 








Create a Landscape using the UEA Editor. The landscape will be assumed to stay an 
screen, We wil only medi its values using code, 





m 


Wiring with UES APIs 


5. Inside your map generation routine, modify your ands cape otjectusing code that 
does the foloning. 


Find the Landscape object in the level by searching through all objects 
inthe Level , We do this using a C+ function that retums TAr ray of all 
Lands tape instances in the levet 
TarrayetLandsezpe!> AChapter126ameMode:: Get Langst 
( 

TarrayeALandscaze'> landscapes 
Wesel level = Getkerel |] 
tori int | = 8) e level-oActors. Moml}; 144 
IN Landscape" land = Cast ohLaneecape>(| evel ohctors]i]] 
D 
Landscapes. Pushy lane ) 
' 


t Initialize the world's ULandscapel nfo objets forALansscape editing 
using the very important ne, wbich is as olus: 
ULandscapelnfa::RecresteLasdecapel atot Getiri el), 1) 








Tre preceding ine of codeis extremely important Without the 
ULandseapel nfa objects wil nat be initialized and yur code wil not work 
Surprsingi this a statie member function ofthe ULsn deca pel f= clas, 
ando RnflaeeallUcanasca3el nfa object thin the ee. 





© Getestents of your ALanéseape object so that we can compute the number 
af height values we will need tn generate. 


© Creates a set of height values to replace original values. 
e CalsLandscapeEdi torUti|s::Set al ghtmapData( |andstape 


fata |. to park new landscape height values into yourA Lands t ape 
abject. 


For example, use the folowing code: 


1 a) REQUIRED STEP: Call static function 
11 ULasdseapel ato: RecreateLansscapel ntal) 

11 Wat this does is populate the Landscape object lth 
fI data values so you don't get mulls for your 

11 Masdrcapel so objects on retrieval 

Wanfscapel nto; RecreateLandscapel afol Getierl dl). 1) 


LU bh Assuming Landscape Is your Landscape object pointer 
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Ej 


|) get extents of Landscape, to compute # aelgnt values 
Fiathest |andocapeaoungs = lansacage->det ound nghert | 





11 c) create height values 

11 Lengscapetaiterdtl |o: Sethel ght mapoata(| adds ane to 

UI each dimension because the Boundary edger my be used 

Int$2 sunset ghts = reci Wet LII ret held) AI) 

array eul at 16> ata 

Data sit( D, rerba gh 

fel isti 0, |e Batata): 148) C 
Hoat me = (i eel] feels: f] normalized a value 
float ny = (Uf cols) (rows: (| normalized y value 
datati] = Periintoise2ot nx, ny, 16, E) 

i 














MU a) Set values a wlth call 
lasiscapetii tor Uti lsi: SetHelghtmapoatal landscape, ata) 


Tre intial aes ofhei ght map wil alibe32768 (HAT. WAX (or 
USHIT MAXI 2+1) when the maps completly fat. Tass because the 
map uses unsigned shorts (u nt 16 or its values, making it incapable of 
taking on negative values. Far the map to dip below et, te programmers 
made the etat value ha of the manmum value ofhel gh mag 


The Perlin noise function is used to generate a height value for x yi coordinate pals, The 
20 version of Prin noise s used so tnat we can get a Perlin noise value based on 2-space 
Spatial coordinates. 


There's more.. 


You can play with the Perin nale functions with the spatial coordinates of the map. and 
assign the heights of the maps to diferent combinations of the Perlin noise function. You will 
want to use a sum of multiple octaves of the Perlin nose function to get mare detail into the 


landscape. 


‘The Fer! i nNai se2D generation function looks as follows: 


Vi 16 AChapter12GameNade: Perl iaMoise20l float x, float y, 


1 
thaat 
fart 


fang. ib actaver, inl pt 1032 gy d 


malse = o.t 
Sere = 1) attave < octaves: octave redd 
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Working with UEA APIS 


JI amplitudes for higher ectaves. Assumag x is orma ized, 


iae ee Roi se1234::pnoise( a'px'octave, y*py'octave, pe. py | 


i 
Fatura USHAT MANIRE + am 














‘The Pet| i nNol +420 function accounts for the fact that the mievel value of the function 
(ea level or fat land should havea valeat SHAT WAX (12763). 





Foliage API 
your level 





Adding trees procedurally to 








The Foliage API isa great wayto populate your level with trees using code I you do ttis 
way, then ou can get some good results without having to manualy produce a natural looking 
randomness by hand. 


We wl correlate the placement of folage with the Prin noise value so that the chance to 
lace a ree at a given locaton is higher hen the Perin noise values are higher. 


Getting ready 


Before using the code interface to the Foliage API, you should ty the in-editor feature to 
tamiiarize ourself with the feature. After that, we wil discues using he code interface to 
wace the foliage in the level. 








Important! Keep in mind that the material far aF ol | ageType object must 
fave the Used with instanced Static Meshes cherkboxchecked in is panel. I 
Yau donot do so, then the material cannot be used to sade a folage materal 








Be sure to check the Used with Instanced Static Meshes checkbox for your 
materials tat you usean ur Fol | 29a T7 Pe, otherwise your Foliage wi 
appear gray 
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How to do it. 


Manually 


1, Frm the Modes panei, si tne petre of a sat roving plant wees B 

2. ciek onthe A Folge Type dras down menu and select ctc re 
Falae oe 

3, Sra Bars Tape jette name wish, 

4. Doübeckc 1o edt our new Fa age ect Selec Mesh tam ur prie 
Bray te shaped oleo pant flage ita the asap wih 

5. Asta Brush ian at ertylyor leg at elek trt par i 
tage 


B. Shift click to erase foliage that youve put down. The Erase density value tells you 
how much foliage t leave behind when erasing. 


Procedurally 
1f you wouid like the engine to distribute the foliage in the leve for you, you have a few steps to 
‘cover before being able to do so from within the editor. Tese steps are as follows: 
1. Goto the Content Browser and right-click to create a fen Fol i ageType objects to 
tribute procedurallyin the lee 
2. CickEdit | Editor Preferences. 
3. Click the Experimental tab. 
4. Enable the Procedural Foliage checkbo This allows you access to the Procedural 
Foliage classes from within the Editor, 
5. Go back to Content Browser, rightclick and create Miscellaneous | Procedural 
Foliage Spawner. 


5, Doubleclick to open your Procedural Foliage Spawner and selectin the 
Fol iageTypes that ou createdin step 1. 

7. Drag your Procedural Foliage Spawner onto the level and size it such that it contains 
the area where you wan your procedural foliage laid out. 

. From the Brushes menu, drag on a fen Procedural Foliage Blocker volumes. Place 
a fen of these inside the Procedural Foliage Spawner volume to block foliage from 
appearing in these areas. 
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Mixing with UEA APIs 


3. Open the menus downwards and cick SIMULATE. The Procedural Foliage Spawner 
should wth age, 
10. Experiment wth the settings to get the foliage distributions that you ke. 


See also 


= The preceding recipe generates foliage prior to gameplay start. If you're interested in 
procedural elage spawning at runtime, see the next recipe, Landscape and Foliage 
API- Map generation using Landscape and Foliage AP 





We can use the eater mentioned landscape generation code to create a landscape, and the 
procedural foliage functionality to randomly distribute some flage ont 


Combining the capables f the Landscape API and Foliage API wil allow you to procedurally 
generate complete maps. In this recipe, we will outine how this is done. 


We wil programmatically create a landscape and populate it with foliage using code. 








To prepare to perform thie recipe, we wil need a UES project with a Gener at e button to kick 
off generation. You can see the Landscape API- Landscape generation wih Peri nose. 
recipe for an example af how to do this. You simply need to create a small UMG UI widget 
Mhathas a Generat e button. Connect the Onli ck event af your Gener ate button to a C++ 
UFUNCTI OM] inside any C++ glabal object, such as your Chapter 12a me Mode object, that 
willbe used tn generate your terrain. 


m 














di 
1. Entera oop that attempts to place N trees, where N is the numberof tres to place 

rancbrry which is specibedintheUPROPERTY(| ofthe Chapt er 12Gane Wade objec. 
2. Getrandom XY coordinates fram within a 2D box bounding the landscape object. 


3. Getlhe Perin noise value (x, y) -You mayuse a diferent erin noise 
formulation than the one used to determine landscape heights fo foliage placement. 
4. Generate a random number. f the number generated is within the range 
of uns of the Prin noise function there, then place a re using the 
Spital i agel nst ance function. Otherwise, do not place a tree there, 


How to do it. 


You should note that we are vering aes in location using 
‘e under randomness in tne spor we choose to test er Dee 
placement Tae actua chance to pisce sie ee depends one 

R Peri noise vave there, and whether tie within the range of unis of 
Perioteeetstve 


‘Very dence tree distributions wil laok ike isocontours on the map then. 
The wit fhe eoconaurs is th range of unis. 





How it 


Perlin noise works by generating smooth nose. Far each location in an interval, (say l-2, 1). 
there is a smoothly varying Perlin nose value. 


rks. 
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Weeki ith UER As — — — — 


Perlin noise values are sampled on a 2D texture. At each pal (and even in between), we can 
eta very smoothly varying noise value. 


Adding octaves lar integer multiples} to some variable that travels in distance across the 
Perlin noise function allows us to get jaggy looking effects; for example, the tufts in clouds or 
crags in mountains are gotten by wider spaced samples, mhich give faster varying noise. 


To get cooL-ooking Perlin naise outputs, we wili simply apply math functions to sampled Perlin 
salues; tor example the sin and cos function can generate some cool looking marble 





Perin noise becomes periodic, that is, abl, with the Perin noise 

dis functions provided bythe ear inked implementation în this recipe. 

L) Bysetaut, Perin noise not periodie Ifyou need our Perin noise to 
be periodic, be careful wich brary functon you are caling. 








The base Perlin noise function is a deterministic function that retums the same value every 
"ime you call it with the same value. 


There's more. 


‘You may also set up sliders inside your Chapt er 12Game Node object derlvative to affect the 
foliage and landscape generation, including parameters such as the following: 
Amplitude of the landscape 
= Density af the foliage 
= tsocontour level for foliage 
= Variance in foliage heightor scale 


GameplayAbilities API - Triggering an 


actor's gameplay abilities with game 
controls 





The Gameplayäbilities API can be used to attach C+ functions to invoke on certain button 
pushes, triggering the game unit to ibt its abies during playin response to keystroke 
events. In this recipe, we wil show you how to do that 


Getting ready 


Enumerate and describe your game character's ables, You wil need to know what your 
character does in response to key events to code in this recipe. 


m 
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‘There are several objects that we need to use here; they are as follows: 


Uca repl ayABi |i ty class-this is needed to derivate the Ce class instances of the 
UGamep! ayAbi 1i ty cass, one derivative class for each abl. 
© Define what each ability doesin.» and. cop by overriding 

available functions, suchas UGaepl ayabi 1i ty: = Acti 

vateabi lity, UGamepl a ABL Tt y: Input Pressed 

cares! apii ity: CheckCost,UGamepl apti Ii ty: i Appl Cost 

Ucamepl ayABi li ty: Appl yoo! down, and soon 
Ganeplayabi lit iesset-thisisa Dat ads ret derivative object that contains 
a series of enum'd command values, and blueprints of the corresponding 
Ucamep! ay Ai | ty derivative casses that depne the behavior for that particular 
input command. Each Gameplayabiltyis Kicked off bya keystroke or mouse click, 
whichis setin Det asl tI nput ii 


In the folloning, we'l implement a Ucamep! sy |i ty derivative called 
UcameplayABi lity Attack fra arri or class object Vet attach this gameplay 
‘functionality to input Command sting ati 1 i t y1, which well activate on the eft mouse 
buton clk 


àl 
2 





LinktheGanepl ayábi 1i ti es APIin yourPrej ect Name. Bui 1d. cs Ble 
Derive a C++ class from UGa mep! ay Ai Lit y. For example, write a CHHUCLASS 
Ucamepl yabi lity. Attack. 
In the very least, you want to override the following: 
E TheuGamep! ayabi lity Attack: :Canäcti vat eli li ty member 
“function to indicate when he actor is allowed to invoke the ability. 
© TheUGamepl ayAbi lity Attack: CheckCost function to indicate 
whether the player can afford to use ability or not: This is extremely 
important, because if this retums false, abilty invocation should fal 
© TheUGameplayAbil ity Attack: :ActivateAbi lity member function 
and write the code that tha arri or is to erecute when Ris At tack abity 
is activated, 


€ TheUGamep! ayabi lity Attack: | nput Pressed member functionand 
to respond to the key input event assigned to tne ability 


Derive a Blueprint css from yourUGamepl ayAbi i ty, At tack object inside the 
VES editor. 





m 


rking with UEA APIs 
5. Inside the editor, navigate to Content Browser and create a. 
Gamepl ayani 1i tisset object by 


«— Right licking on Content Browser and selecting Miscellaneous | Data 
asset 


Inthe dialogborthatfollows, select Gamepl ayb || i tySet for Data Asset 
Chass 





Infact the Gameplay Abi|itySet otjectisaUDat ahsset derati. 
Wis located in Gameplay Abi ty Set ^ and contains ange member 
QQ function, Gamepl ayAbi 1i tyset: Gi vedbi L1 ti es) which istongy 
© recommend you nat to use for reasons Isted in a later step. 





15, Name yourGamepl ayAbi Ii tySet data asset something related to the 
Warrior ebject so we know to select tinto the War ri or class or example, 
Marri or Gamepl ayabi Ii tySet) 

T. Doubleclick to open and editthe new Warri or Abi Ii tySet Data Asset. Stack in 
flit Gameplay Abit} class derivative Blueprints by clicking «on the TAT tay 
objectinside of it. Your UGanepl ayahi it y, At tack object must appear in the 
dropdown. 

B. AMJUPROPERTY UGamepl syl i tySet* gameplayAbi|tySet member to 
yourtarri or class. Compile, run, and selecti Warr gr Abi I ty Sat as itits 
in Content Browser (created in steps 5 to 7) of the abilities thatthis ier is 
capable ol. 

3. Ensure that yourAct er class derlvative also derives from the 
UnbivitySystemi nter face interface, This is extremely important so 
that calls to( Castel Abi li tySystem nter Face» yourăctor)| 


>GetAbilitySystemConpanent] succeed 
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10. Sometime after the construction of your actor, calla zmepl ayAbi Ii t ySet 
>Giveabilities| abilitySystentonponent ]; orenter a loop, as 
shown in the following step where you invoke abi 1i t ySystemtomesent- 
SGi vebi Tit yl) for each abil fsted in your gamer! aybi T ty Set 

11. Wite an override or Marr or: : SetupPl ayer Input Component ( 
UinputComponent* input | to connect the input contoler to the Warriors 
‘Gameplaytbity activations, After doing so, terate over each Gameplay listed in 
your GameplayAbiySet's Abilties group. 








Donatuse the amen! spit it get Gi vebi tien 
is] member funcion because it doesn't ge you actes tthe set of 





Féareplayhal i t ySpeclandl e objects that you actually ned to 
iater bind and invoke the abit to an input component. 


volá aMare|ors:SetuphlayertaputConposent| UI aput Component” Input | 
D 

Supers: Set upPiayerlnpatCompanest| Input 

I Connect the class's biti tySystencamponent 

1) to the actor's input composent 

Abii |tySpstanconpenent- obi raTa nputCenpenest| Input ) 


|) Ga thre each Bindiafo in toe ganeplayaBilitySet 
|) Glee G try ang activate ence on the Abi ity Systenconponent 
Far const FGamepiayabiiitytiadinfok Bindlafo 
anepi ayati li tyset->ABi ities | 
t 
JI aindinta has 2 members: 
JI Command (enum val ee) 
Ji “Gamepl ayabilityCl aus (Utlass of a Ucameplayáti lityi 
APU alata Gamepl ayabi ttl ass ) 
D 
frror| FS{ *GaneplayabilicyClass 44 not set 
(i ne32) Bia nfo. Command ) 1 


) 








FoameplayabiitySpee spect 
JI Gets you an instance af the Ulass 
Minds e Gamepl spit ligas 

Get De al to] ect sUGamepl ayasi Lt yo) 
10 (nt2) inl ee. Command | 
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"Werke With UER As oo 


JI STORE THE ABILITY MANDLE FOR LATER INVOKATI OV 
DERE 

Foaneplayability/Spectansle abili tykaadle 

bit itySystenComponent= 9G velbil DC spee d 


J) The integer id tat invokes the ability 
JI (ith valee ia enum listingi 
irt32 AlTA EyID = rt MIT Bi sd oto. Command 


J1 CONSTRUCT the irati nds object, which wiii 
Jí allow us to wirerup an iaput event to the 
JI Inpurtressedl] | Inpatheleasedi) events of 
JI the Gameplayabi lity 
F6amepl ayab Ii yl nput Bi nds i aputBi ads} 
TI These are supposed to be unique strings that detine 
11 what kicks off the ability for the actor Instance 
11 Using strings of the Format 
11 "nfi rmfargetti ni. Payer Abit ity ass 
FSI "Conti rmargettini See. * Get Namel) 
Mindi nfo. Ganepl ayAè II EYCI ass Get Manel] } 
FSI "cancel targetting. As Sos, "Get Namel) 
dato. GaneplayabilieyCiass->cetdane() ) 
“Gameplay Al rtg aput init, J] The name af the ENUN that 
1] has the abilities Listing CGameplayAbilityset, b) 
Abr eyED, abit 
1 
ji MUST BIND EACH ABILITY TO THE INPUTCONPONENT, OTHER SE 
JI THE ABILITY CANNOT HEAR" INPUT EVENTS, 
J Enables triggering of InsetPressedl} | InputRel easet] 
JI events, which you cas incturn use to call 
J1 Trydctivateasility() Lf yau so choose 
Abi itySystencomponent->Bi ngdAbi Ii tyActi vati anTol sput Component | 
epit, input Binds 
1 





Jy Test-bleks the ability to active state 
Jí You can try inviting this manually via yoat 
JI am neokups to keypresses in this Warrior class 
J1 Tryactivateability0) calls activateabi litl} LT 
J) the ability it ladeed |aveuable at thie Uime according 
Jí to rales internal ta the AbIVity"s class [such as conl dowe 
JI Us ready and cost 1s met) 
Abii itySystencamponent >Tryäcti vat eAbi ity 
abili tytandies 1T 


-gn 
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‘You must subclass and linkin a setof Games ay Ability objets to your actors 
UsbilitySystemComponent object through a series of cals tabi |i t ySyst enCompo 
ment: GiveAbility(_ spec ) with appropriately constructed GamepiayAbi lity Spe 
objects. What this does is it decks out your actor with this bunch of Games ayAbi 1i ti es 
‘he functionality ofeach UGaserl ayabi 1i ty, ts cost, cooldown, and activation is ali neatly 
contained within the Uca "ep! ayab! ty class dertalle that you wil construct 


There's more. 


‘oul want to carefully code in a bunch of the other functions that are availabe in the 
Gameplay abi 1i ty. header He, inducing implementations for the following: 


^o SendGamepl ayEvent: This is a function to notify Gameplay that some general 
{gameplay event has happened, 

= Cancel Abi i ty:This is a function to stop an abiltys usage midway through and 
giving the ability an interrupted state. 

= Keep in mind that there are a bunch of existing UP ROPERTY near the bottom of the 
Ucamep! apii |i ty cass declaration Mat either activate or cancel the ably upon 
addition o removal of certain Ga sep 2) Tags. See the following GameplayTags 
API- Attaching GameplayTags to an actor recipe for more detais. 

= Abunch more! Explore the API and implement those functions you prd to be sel in 
your code. 


See also 


‘The Gamepl ayAbi iti es API is a rich and nicelyinterwoven series of objects and 
functions. Reallyexplore Gamepl yt fects, Gamepl ayTags and Ganepl ayTasks 
and how theyintegrate with the UGa epl ayAbi 1i t y class to fully explore the 
functionality the library has to offer 


GameplayAbilities API - Impl 


ributeSet 


TheGamepl ayAbi i ti es API allons you to associate a set of attributes, thats, 
Uat tri but eset toan Actor, Uit t ri but eSet describes properties appropriate for that 
‘Actors ingame attributes, suchas Hp, Nana, Speed, Ar mor At tack Damage, and so on. 
You can ether depne a singe arene set of attributes common to all Actors, or several 
different sets af attributes appropriate for the different classes of actors. 








winwns 


Getting ready 


Abi L tySystesComponent is the rst thing you wil need to add to your actors to 
equip them to use GameAblities API and ultri but eset s To debre your custom 

DAt Eei But eset «you wil simply derive from the UAt £ | but eSet base class and extend the 
base clase with our own series of PROPERTY members. Alter that, you must register your 
customat tri ut eSet with youracter class'abi Li tySystesComponent 


How to do it. 


1. LinktotheGamepl syhbi |i ti es AP yourPr oj ect Mame, Sul |d. cs He 
in its oun ble, derive fromthe lat tri but eset elass and deck the class out with 
a set of UPROPERTY that you want each Actor to have in thei property set For. 
‘ample, you might want to declare your Latt r i tut eset derivate class similar to 
the following piece of code: 
include “Aunt ne) Gamepl ayAbI I i ties) Public Attr i buteset 
tel cde Cameli tA Eri buteset generated. 











UCLISSI BL ceri ntabie, M ueprintTypel 
class CHAPTERL2 APL UsameUni attri euteset © public 
Unters suteset 
í 
cenenaten aon) 
MGameuni tattri bateset| const FObjectinitializerä PCI? ): 
UPAOFEATY( EaltAnyutere, Bluepristkeadikite, Category = 
Gamslnieateritucer | float dp 
WPAOPEATY( Ed LAnjweere, BluepriatReadirite, Category 
anslni attributes |. lost Mena, 
PROPERTY Eel Any wrere, El uapristfeadthite, Category = 
Canslnisaterituver | flat speae 
I 


your codes ered you right wants nal eplcaon 
TR, preachortneLPAGPERTT win ees cron ie 
Shscreett mace 








3, ConnectGane Uni Lit tri but eset with yourdbi Lt Spit emCemanent inside 
your Act ar class bycaling the folowing code: 


Aot ySystencomonent seit Stats 
Usame titer bateset Stati eti aes(), ML) 


-gnj 
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‘You can put this call somewhere in Pest! ni ti ali eComposent el orin code 
hatis caled later than that, 


4. Once you have registered UAt ri but e5 et , you can move on wih the no recipe 
and applyGazepi ayEt ect to some of the elements in the attribute set. 

5. Be sure youract or class object implements I Abi Lit Syst es nter tace by 
dering fem it. This is extremely important as the Uab || 1 ySet object wil attempt 
actio Abii tySystem ntertace locallGet io Li ty/Systencomponent || 
n t at various places in the code. 


Unt tri but eset s simpiyallowyou to enumerate and debe attributes af different actors. 
ares! ay£t ect wil be your means to make changes to the atribues of a specie actor. 


There's more. 


You can code in deþnitions of Games! 2y fect s which will be things that act on the 
Deliysystenicomponents it ri tat eset collections, You can also write Ganep! ays ks 
for generic functions that run at sped ime ar everts, or even in response to tag addition 
(SameplayTagResponseTabl e. cpp). YoucandeþneGamepl ayTags to modify 
‘Gameplaytbilty behavior as well as select and match gameplay units during play. 


GameplayAbilities API - Impl 





Abuffis just an effect that introduces a temporary. permanent, or recurring change to a game 
nis atiibutes from is At ti but eset. Bulls can either be good or bad, supplying ether 
bonuses or penalties. For example, you might have a hex buff that slows a unit to half speed, 
an angel wing buff that increases unit speed by 2x or a cherub buff that recovers 5 h every 
þe seconds for three minutes. AGamep la yE! T ect affects an indidual gameplay attributes 
Intheuattri but eSet attachedtoanAbi Ii tySyst enComponent ofan Actor. 


Getting ready 


Brainstorm your game units’ fects that happen during the game. Be sure that youve created 
an Attri but eset shown in the previous recipe, with gameplay attributes that you'd ike t» 
affect Select an effect to implement and flow the succeeding steps with your example. 








rking with UEA AP 


YoumaywanttotumLogabi 11 ty5ystemtoa ver yverbese 

“eting by geing ta te Qupul Log and ping a tren Log 
4 UogAbilitySystem All 

“is i depiaymuch more nrraten tem tiit Syst emin he 

Output Lag, making easier to see what going n wh estem. 


How to do it. 


In the folloning steps, we'l constructa quick Gameplay =f tect that heals 0 hp to the 
selected units Aver but ese 





1. Constuct youruGamea! sy E! fect class object using the CONSTRUCT. CLASS macro 


vith the following Ine of code 


|) Create GameplayEftect recovering SO hp ane time only te 
(CONSTRUCT ELASS{ Gameplay Effect, Recaverd? ) 


2. UsetheAddMasi tier function to change the p bed ofGameUn ttt ribut eet, 


as fons 


Aaanaeifier| Recover 
GEL FIELD CHECEED| Unete rit tri noteset, ap ) 
Giep|aytodOp:; Aadit ve, cal gb eFleat( SOF |) 


3. Filinthe other properties of Gaseg! ay Et T ert, inducing lds such as 


Durat i sabor cy andChanceTodgp! yToTarget oranyather pals that youl the 


to modiy as falows: 
Aecoverst-sburati antol icy 
EkameplayEtfect ur stl sn Toe: HasDurati an: 

Recovers? sburatl onkagni tage = FScal abl efi aat( 10.4 ) 
Recoverst-ochanceTedpel ylaTarget = Lf 

Recovers? oPeriag = St 


4. Applytheelfectto an Abii tySystenConpenent of our choice Te underlying 


Witte tat eset wil be affected and modied by yur call, as shown nthe following. 


piece of code: 


Facti aeGameplayEf ect and e recover kpEt ec 
aei tySystemčanpanent-»Appl yGamepl ayEt ecs 


asi tySystemcomponent, LE) 


van 
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Gamepl ayEff ects are simply litle objects that efect changes to an actors At tr i but eset 
Gameplay Ef ects can occur once, or repeated in intervals over a Per i od- You can 
programin elects pretty quickly andthe Ga sep ayEt T ect class creation s intended to be 
fine. 


There's more. 


(Once the Gamepl ayEt fect is active, you wilreceveanF Acti veGamepl ayEt fect Handl e 
‘You can use this handle to attach a function delegate to run when the effect over using the 
OnkemsvecDel egat e member ofthe Fact reGaepl ayEf fect Kandi e. For example, you 
might cal: 

Fact veGemeplayttfectiandl e. recoveroHl ert handle = 

Abit itySpetenconponent- opp! yCaneplayEtfactTeTarget( Recover HP, 

Ati Lit ySystentomponent, 1f | 

It recaverdpettectienale ) | 

Fecoverhpētfect Handi e->Adélambdal LIC) { 
Intal "RecoverMp Effect has been remved.* ) 


n 





GameplayTags API - At 


GameplayTags to an Actor 





Ganep! ayTags are just small bits of text that describes states [or buffs) for the player 
or attributes that can attach to things such as Ganepl ayabi tities and also to 
describe Ga nepi ayEf fects, as well as states that clear those effects. So, we can have 
Ganepl ayTags ,such as Heal ing or Sti mned, that viger various Game pl ayAbi i ti es 
orGamep! ayEf i ects to our iking. We can aiso search for things via Garep a) Tags and 
attach them to our Abi itySystemcampanent Ife choose, 





Werking with LE AP 


How to do it. 


There are several steps to getting Ga mep! ay Ta gt to work comet inside your engine bul 
they ae as follows: 


A 


-gnj 


Fist we wil need to create Data Table asset to carry al of aur game's tag names, 
Right-click on Content Browser and select Miscellaneous | Data Table. Selecta 
table class structure deriving from Ganepl ayTagTatl ehe, 





Lstalltags available inside your game under that data structure. 


ASMUPROPESTY( | TArray<f String> to your GameMode abject to list the 
names ofthe Ta gTab I cames that you want to load into the Ga repl ayTags 
module manager 

PROPERTY Edi rangers, Biueprintheadirite, Category 
Ganep ayTags | 

Theray<FString> Ganep!ayTagTabl ehanes 





In your GameModes Pos ti ni t al i reConponent s function, or later, oad the tags 
inthe tables of your choice using Get Ga meri aj T29sHanage 

| GameplayTagsModul e: : Get]. Get Gameplay Tageuanager (| 
LazdGameplayTagTabie( Gameplay TepTabl elamas 


Use ura nep! ayTags Inside each of ur Gameplailtyobjecs, you can 
‘modify the bockedness, cancelabi and activation requirements for each 
‘GameplayAbity using tag attachment or removal 





Em 
E 
tam 
Em 
rm 
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‘You do have to rebuild your engine in arder to get your tags to load within the 
‘editor. The pateh to the engine source that is proposed allons you to hook in a 
calitoi amepl ayTags Nodul e: : Get]. Get Gamepl ayTagsManager | 
Dads esl sy TagTabl el GameplayTagTabl eNames 


To get this call embedded into the editors startup, ou wil need to edit the engine's source. 





Ganepl ayTasks are used to wrap up some gameplay functionalityin a reusable object. Al 
you have to do to use them is derive from the UGanep! ayTas k base class and override some 
‘of the member functions that you prefer to implement. 


Getting ready 


Goin the UES Editor and navigate to Class Viewer. Ensure that you have inked in the 
ames! ayTasks APlinto your Pr oj ect Name. Bui 14. £s He and search vith Actors Only 
tickbax off for the Gamepl a Task object pe 


How to do it... 


1. Ensure that you have linked Gameplay Tasts API into yourPr ej ect Name. Bui 1 d 
ts He. 

2. Click on File | Add Ci Classé Choose to derive from Gas sj Task. To do so, you 
must rst ick Show All Classes, and then pe ga mep! ayt 35 into the tr bac 
lek on Next, name your C++ class (something ike Ga ep! sjTsst. Task lame is 
"he convention) then add the cass o your project The example spans a particle 
emitter andis called Gamepl ayTask Creat eParticl es 

3. Once yourGanepl ayTask Creat efarticles.n and. cpp pair are 
created, navigate to the. He and declare a static constructor that creates a 
Gamepl ayTask. Cresteharticl es object for you 


Usamep|ayTask_createParticlest Ucamepl aytast. 
Crantenarticl iss. Construct Taek 


Técri pti nterlacee GanepizyTastOwrer|stertace> Tastowrer 
parti cl eSystem partici esystem 
Feston Locatia 





UcameplayTast cresterarticlest task e 
NewTaskeUGamepl ayTask Crest Porti ciesa Teskowne 
JD HN fields 








mL 


Working wth UEA APS 


mn 
' 
tasks sparticleSystem = partic eSystem 
taskoslocation = | cation 
d 
Fetarn task 
1 


4. Override the UGamep! ayTask_Creat emitter: Acti vat el) function, which 
contains code that runs when Gamep! ay Tas k I effected, as follows: 
Vaid UGameplayTask_createtwitter::Acti vatel| 
( 
Super: Acti tel] 
UGaneplayStatics:: SpzuntnitteratLecatl on} Get Nori d0). 
Part iel eSysten otetdef ult nj ect elPartieleSystem! | 
1 


5. Add Ganepl ayTastsConponent toyourAct or class derivative, which is available 
inthe Components dropdown of the Components tab n the Blueprint editor, 
6, Create and add an instance of your Gars! Task inside your ket er derivative 
instance using the following code 
UsameplayTask_createParticles* task 
UWGaneplayTaik Crest ebart cl s: i ConstructTaskl this 
particlesystem Pectorl 0., 0.1, 200. | ) 
1I GaneplayTaskscomponent | 


ampl ayTastsComponent->4ddTaskeadyForActi vati os| "task | 
7. This code uns anywhere in yours or css derivative, anytime 

atter Ganep! ayTasks Component is initialized (anytime after 

Postini tial izetonponents(] h 


Gamepl ayTasks simplyregster with the Games! 2yTasts Component situated inside an 
Att or dass derivative of your choice. You can activate any number of Gamez sy Tasks at 
anytime during gameplay to bigger their effects. 


Gamepl ayTasks can also kick off Ga mep! ay Et fects to change attributes of 
ADIT tySystensConponents Ifyou mish 
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There's more, 


‘You can derive Gamep! ayTas ks for any number of events in your game, What's more is that 
ou can oversea few more virtual functions to hook into addtional functionality. 





HTTP API 


When youre maintaining scoreboards or other such things that require regular HTTP request 
access to servers, you can use the HTTP AP! to perform such web request tasks, 


Getting ready 


Have a server to which youve allowed to request data via HTTP. You c 
any type to try out HTTP requests If you'd Ike. 


How to do it.. 


1. Unkto the HTTP API in your rij ect ame. Bui Ld. cs He 
2. Inthe Hein which you wl send your web request, include thet t podu! e 
header pe thes planager, à header He, and thest tahet r yyt em. h e, as 
shown in the following code snippet: 
#i ncl ade “Runtime Onl i ne/ ATTP/ Publ | cf Het psa. h 
inclite “Runtime Onl | ned ATTP/ Publ ciet pede 
nel ade “Runtime Onl | ne/ TTL Publ | ef HttpRetrysystem N 











3, Constctan dts pRequest object fram it t podul e using the following code: 


Tsharedhet ei Httpteguest> 
itpstttpModel e: Ge ||. Createñequest() 


Gh, Fitiplodae isa ingetan objet One copor it ests rte 
TY) Fer pregam tt you are meant oe eral trace mia the 
3 


Ft Epilogu e cas 


4, tach your function to unto thel tt pRequest object's 
Fhe tpRequest Compl eteDel egat e, which has a signature as follows 
veld AttphequestConplete( FttpReguest?tr request 
Fattpherponsertr response, bea! success 








a 


Mixing with UEA AP 
5. The delegate is found inside of the! Ht phesuest object as htt p 
>OnFracesstequest Comp! etel] 


FatepRequest Compl ateDel egilek delegate = http 
DdanbFacessReguett Comp atel | 








There are a few ways to attach a callback function to the delegate: You can use the 
folowing: 


© Alambda using! agate. Bi adLanéda|) 
del agate, 81 néLantéa| 
|) Anenymous, inlined cote function (aka (ame3) 
[|| Fattpaequesteer request, Fittphesponcertr response 
success ) -> void 
i 
UE LOG) LagTemp, Warning, TEXTI "Hip Mes 
D 
request-saet hespossel |->GetResponsetodel) 
‘request-aGetRespense||->detContentasstrieg() | 











© Any UObject's member function: 
delegate. Bi adU0s) ect] this 
kachapter12GameMiode:: Mttphequest Complete) 


You cannet atach tau uct drt nere as the 
Vy Erste ani) command aun argument tt 
venues USTU att 


&— Anyplain old C++ objets member function using. Bi ndaw: 
Paindhject* plaindsject = sew Pial 208 ect() 
delegate. Madham gl zindhj ect, GPlalnOhject::httphandler 
1 


Ji glaletbject cannot be DELETED Until bttpHandier gets 





Nou have tes that your pi an] ect velers toa wal eben 
meneny at 1e tins he requ capes To means Mat pu 

u Cannot useTAutoPtr on pl ai Oh ert because tat wil deslbcate 
Feds) et at ie end at e cs nah ti sere at at 
fae bee tbe HTP ree cones 
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© Aglobal Cate stati function: 


JI Geatyle function for handling the HITP response: 
void attphandl er| PittphenoestPtr request 
frttphesponsePtr response, Bool success | 

Isfol "static: Heep req handled | 
) 
fel agate Miadstatic| aber pHandler ) 


Vhen using a delegate callback wth an object, be sure thatthe object 
Instance that youre cating back on Ives on at least until the paint at 
mhich the Ni t paes pons e aries baci from the serier. Processing the 

Št tpRequest takes real bme to tun. Iisa web request after all ink of 
waiting tora web page to ad. 

You have to be sure that the object instance on which you're caling the 
fallback function has not deallcated on you between the tme of the ial 
tall and tne invocation of your Ht pan er fncton.Theobject must stil 
bein memory when te calback retums ater the HTTP request completes. 
You cannot simplyeectthat the Ht t pães ponse function 

happens immediately after you attach the callback function and call 
ProcessRequest (| !Usinga reference counted UDo] ect instance to 
attach the Http anal er member function i a goad dea to ensure hat the 
‘bjt stays in memory unt the HTTP request completes: 





65. Specltythe URL af the site you'd Ike to hit- 
Mttp->set URL, TEXTI *http:syunreal engi se co |} 


T, Process the request bycaling Process Request 
hetp-stracesshequest(| 


How it wo 


The HTTP object is all you need to send off HTTP requests to a server and get HTTP responses. 
‘You can use the HTTP request response for anything that you wish for example, submitting 
scores to a high scores table or to retrieve text to display ingame from a server, 


They re decked out mith a URL to isitand a function calbac to run when the request 
is complete. Finally they are sent off ia F Nana ger „When the web server responds, your 
Callback is called and the results of your HTTP response can be shown. 





J- 


erking with UEA APIs 


There's more, 


‘You can set additional HTT request parameters via the following member functions: 


= SetYerb[ | to change whether you are usingthe GET orP OST method in your 
HTT request 


= Set Headers) to modifyany general header settings you would ike 





r 





HTTP API - Progr 


Thel Htt pRequest object fom HTTP API will report HTTP download progress via a callback 
na Fit tphetues t Progress Del egat e accessible va Onteques tPr ogress (1. The 
Signature of the function we can attach to the On Request Pr opt ess (1 delegate is as 
flows: 


Hindi elegeesthrogress| FHttphequestPtr request, int32 
Senteytes, int32 racer vedbytes | 





The three parameters of the function you may write include: the original Ht peques 
object he bytes sent, and the bytes received so far. This function gets called back periodically 
Uuntilthe Ket Request object completes, which îs when the function you attach to 
OnProcessheguest Compl etel | gets called. You can use the values passed to your 

Handi ekequest Progress function to advance a progress bar that you wil create in UMG. 


Getting ready 


You will need an temet connection to use this recipe. We wil be requesting a be froma 
public server. You can use a public server or your own private server for your HTTP request if 
yeu ike. 





In this recipe, we wil bind a callback function to just the OnRequest Progress(| delegate to 
splay the dounload progress of a e from a server Have a project ready where ve can write 
a piece of code that wil perform Hit pRequest, anda nice interface on wich to display 
percentage progress. 


How to do it... 
1 


Link to the UNG and KIT? APIs in ur?ro] ect Mame. Build. cs He 
Build a small UMG UI wh Pr ogr essc to display your HTTP requests progress. 


Constuctani tt pReauest object using the following code: 
Tsharedhef a Httpheguest> bttp = 
Hsu Ge) createneguest| 








Chapter 12 


4. Proide a callback function to cal when the request progresses, which updates a 

visual GUI element: 
ttp- sonRequest Progress). Bindtanbdal (1 Pittphegeest?tr 
Fequest, R3] sentaytes, atid recelvediytes | c» vale 
t 

Inta? tatal Len = request->Get Responsel 

>et Content Lengt A). 

float gere = [tl eat)recelvedeytes) total Len 

Lic MetaPragressbar | 

WitaProgressBar. >Set Percent( pere 
n 








5. Process your request ih stt z->Pr acess Request) 


‘The nRequest Pr ogress |) callback gets fred everyso often wt the bytes sent and bytes 
received HTTP progress. We wii compute the total percent of the download that s complete by 
Cakulating (toat )receivedayt es) otal Len, wheret otal Len isthe HTTP responses. 
total length in bytes. Using the lambda function we attached to the DnRequest Progress 

delegate callback, we can cali the UMG widgets. Set Per cent L} rember function t reject 
the downloads progress. 
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